Transaction creation service
Call details#
- 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. | < 12 N | YES |
customer_id | Customer identification for card storage. | < 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. | < 4 N |
message | Carat Portal response message. | < 500 AN |
| store | ||
status | Status of the storage transaction on Carat Portal. Learn more. | = 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. | < 12 N |
customer_id | Customer identification for card storage. | < 20 AN |
store_token | Token related to the JavaScript store. | = 66 AN |
Response codes
See reference on API codes - response codes