# Transaction Creation Service

import ResponseCodes from './codigos-de-resposta.md';
import ApiDoc from '../../../../../src/components/api-doc/ApiDoc';

## Call details

<ApiDoc method="post" path="/e-sitef/api/v1/store" />

- **Resource:** `/v1/store`
- **HTTP Method:** `POST`
- **Request format:** `JSON`
- **Response format:** `JSON`
- **Header parameters:**
  - **Content-Type**: application/json
  - **merchant_id**: {your merchant id}
  - **merchant_key**: {your merchant key}

Calling this service is mandatory in the JavaScript store flow.

## Request parameters

The following request parameters must be sent:

| Parameter      | Description                                         |     Format     | Mandatory |
| -------------- | --------------------------------------------------- | :------------: | :-------: |
| `merchant_usn` | Unique sequential number generated by the merchant. | <u><</u> 12 N  |    YES    |
| `customer_id`  | Customer identification for card storage.           | <u><</u> 20 AN |    YES    |

## Response parameters

In the table below is the description of the response parameters:

| Parameter      | Description                                                                                                                   |     Format      |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------- | :-------------: |
| `code`         | Carat Portal response code. Any code different from `0` (zero) means failure. [Learn more.](codigos-da-api.md#response-codes) |  <u><</u> 4 N   |
| `message`      | Carat Portal response message.                                                                                                | <u><</u> 500 AN |
| **store**      |
| `status`       | Status of the storage transaction on Carat Portal. [Learn more.](codigos-da-api.md#storage-status)                            |     = 3 AN      |
| `nsua`         | Unique sequential number of the storage transaction on Carat Portal.                                                          |     = 15 AN     |
| `nita`         | Encrypted store transaction identifier number returned to the store by Carat Portal.                                          |     = 65 AN     |
| `merchant_usn` | Unique sequential number generated by the merchant.                                                                           |  <u><</u> 12 N  |
| `customer_id`  | Customer identification for card storage.                                                                                     | <u><</u> 20 AN  |
| `store_token`  | Token related to the JavaScript store.                                                                                        |     = 66 AN     |

<ResponseCodes />