account
per requestData Field | Variable Type | Description | Example |
---|---|---|---|
requestId (Required) | string | UUID | 5f954e17-27c2-46d5-b0ed-f28149267500 |
network (Required) | string | The card brand | This field can only have one of the following values: visa or mastercard |
accountEncrypted (Required) | blob | Contains the account (URL-safe base64 encoded). Format: JSON Web Encrypted string using the RequestEncryptionKey. Validation: The accountNumber in this list must be unique. | |
subMerchantId (Nullable) | string | For Visa, American Express, and Discover, a sub-merchant ID between 1 to 12 characters. For Mastercard, a 15 character sub_merchant_id issued by Mastercard |
Data Field | Variable Type | Description | Example |
---|---|---|---|
accountNumber (Required) | string | Value of length between 13 to 19 characters | 1111111111111111 |
expiryYear (Required) | string | Value based on YYYY format | 2024 |
expiryMonth (Required) | string | Value based on MM format | 09 |
metadata (Nullable) | string | Value of length between 1 to 50 characters | 51032475-bc83-46d8-8768-15e129f3c6e0 |
Data Field | Variable Type | Description | Example |
---|---|---|---|
code (Required) | numeric | HTTP response code | 200 |
requestId (Required) | string | UUID | 5f954e17-27c2-46d5-b0ed-f28149267500 |
accountEncrypted (Required) | blob | Contains the account (URL-safe base64 encoded) |
Data Field | Variable Type | Description | Example |
---|---|---|---|
accountNumber (Required) | string | Value (13-19 characters) | 1111111111111111 |
expiryYear (Required) | string | Value based on YYYY format | 2024 |
expiryMonth (Required) | string | Value based on MM format | 09 |
newAccountNumber (Nullable) | string | Value (13-19 characters) | 2222222222222222 |
newExpiryYear (Nullable) | string | Value based on YYYY format | 2023 |
newExpiryMonth (Nullable) | string | Value based on MM format | 10 |
responseCode (Required) | string | A code from the Response Codes table | LCA |
errorCode (Nullable) | string | A code from the Error Codes table | LE01 |
metadata (Nullable) | string | Value (1-50 characters) | 51032475-bc83-46d8-8768-15e129f3c6e0 |