# A2C

Maximum amount for an A2C transaction request is **29,999.00 UAH**.

Exceeding this limit results in an error:

```
ERROR: @Payment coin amount exceeds the limit
```

## **Input Parameters**

<table data-header-hidden><thead><tr><th></th><th width="197.800048828125"></th><th width="180.5999755859375"></th><th width="93"></th><th></th></tr></thead><tbody><tr><td>Parameter</td><td>Description</td><td>Data Format</td><td>Required</td><td>Example</td></tr><tr><td><strong>merchantRequestId</strong></td><td>Unique identifier generated by the merchant system, used to check the transaction status in case of an unknown error or disconnection.</td><td>string(36)</td><td>Yes</td><td>137d9304-0368-11ed-b939-0242ac120002</td></tr><tr><td><strong>encryptedCardNumber</strong></td><td>Recipient's card number encrypted in JWE format using a payment key.</td><td>string</td><td>Yes</td><td>5473670000000304 (decrypted form)</td></tr><tr><td><strong>coinAmount</strong></td><td>Payment amount.</td><td>int</td><td>Yes</td><td>2000</td></tr><tr><td><strong>merchantId</strong></td><td>Merchant ID generated in Ecom.</td><td>string(36)</td><td>Yes</td><td>137d9304-0368-11ed-b939-0242ac120002</td></tr><tr><td><strong>date</strong></td><td>Date and time of the transaction.</td><td>string</td><td>Yes</td><td>{{currentdateT}}.00+00:00</td></tr><tr><td><strong>notificationUrl</strong></td><td>URL where the callback will be sent.</td><td>string</td><td>No</td><td>https://merchant.notification_url</td></tr><tr><td><strong>notificationEncryption</strong></td><td>Indicator for callback data encryption.</td><td>string</td><td>No</td><td>true/false (If not provided or set to false, callback data will not be encrypted.)</td></tr><tr><td><strong>comment</strong></td><td>Additional payment information.</td><td>string</td><td>No</td><td>///5555.25412</td></tr><tr><td><strong>purpose</strong></td><td>Payment purpose.</td><td>string</td><td>No</td><td>For goods</td></tr><tr><td><strong>merchantComment</strong></td><td>Additional merchant order comment.</td><td>string(255) <br><br>a-zA-Z0-9 ,.;:@#$%'-=+1,256$</td><td>No</td><td>merchant Comment id 1258728c1</td></tr><tr><td><strong>senderAccount</strong></td><td>Sender's account number.</td><td>string</td><td>No</td><td>2900000000000</td></tr><tr><td><strong>customerData</strong></td><td>Object containing customer data.</td><td>object</td><td>Yes</td><td>-</td></tr><tr><td><strong>senderCustomerId</strong></td><td>Sender's customer ID.</td><td>string(255)</td><td>No</td><td>1258728c1</td></tr><tr><td><strong>senderFirstName</strong></td><td>Sender's first name.</td><td><p>string(30)<br></p><ul><li>the value cannot contain only numbers</li><li>cannot contain periods or other special characters</li><li>cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”</li><li>only alphanumeric values ​​are allowed</li><li>can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“</li><li>a hyphen or space can be inside, but not at the beginning or end</li><li>For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027</li></ul></td><td>No</td><td>Ivanenko</td></tr><tr><td><strong>senderLastName</strong></td><td>Sender's last name.</td><td><p></p><p>string(30)</p><ul><li>periods or other special characters</li><li>cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”</li><li>only alphanumeric values ​​are allowed</li><li>can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“</li><li>a hyphen or space can be inside, but not at the beginning or end</li><li>For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027</li></ul></td><td>No</td><td>Ivan</td></tr><tr><td><strong>senderMiddleName</strong></td><td>Sender's middle name.</td><td><p>string(30)</p><ul><li>periods or other special characters</li><li>cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”</li><li>only alphanumeric values ​​are allowed</li><li>can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“</li><li>a hyphen or space can be inside, but not at the beginning or end</li><li>For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027</li></ul></td><td>No</td><td>Ivanovich</td></tr><tr><td><strong>senderEmail</strong></td><td>Sender's email.</td><td>string(256)</td><td>No</td><td>mail@gmail.com</td></tr><tr><td><strong>senderCountry</strong></td><td>Sender's country.</td><td>string(3)<br>ISO 3166, 804 for Ukraine</td><td>No</td><td>804</td></tr><tr><td><strong>senderRegion</strong></td><td>Sender's region.</td><td>string(255)</td><td>No</td><td>Kyivska</td></tr><tr><td><strong>senderCity</strong></td><td>Sender's city.</td><td>string(25)</td><td>No</td><td>Kyiv</td></tr><tr><td><strong>senderStreet</strong></td><td>Sender's street address.</td><td>string(35)</td><td>No</td><td>Sichovykh Striltsiv</td></tr><tr><td><strong>senderAdditionalAddress</strong></td><td>Additional address details (floor, house number, apartment).</td><td>string(255)</td><td>No</td><td>23</td></tr><tr><td><strong>senderItn</strong></td><td>Sender's tax identification number.</td><td>string(20)</td><td>No</td><td>123456789</td></tr><tr><td><strong>senderPassport</strong></td><td>Sender's passport number.</td><td>string(255)</td><td>No</td><td>AN123456</td></tr><tr><td><strong>senderIp</strong></td><td>Sender's IP address.</td><td>string(50)</td><td>No</td><td>123.12.12.12</td></tr><tr><td><strong>senderPhone</strong></td><td>Sender's phone number.</td><td>string(20)</td><td>No</td><td>380630000000</td></tr><tr><td><strong>senderBirthday</strong></td><td>Sender's birth date.</td><td>string(50)</td><td>No</td><td>31.12.2000</td></tr><tr><td><strong>senderGender</strong></td><td>Sender's gender.</td><td>string(50)</td><td>No</td><td>Male/Female</td></tr><tr><td><strong>senderZipCode</strong></td><td>Sender's postal code.</td><td>string(50)</td><td>No</td><td>49000</td></tr><tr><td><strong>recipientCustomerId</strong></td><td>Recipient's customer ID.</td><td>string(255)</td><td>Yes</td><td>1258728c1</td></tr><tr><td><strong>recipientFirstName</strong></td><td>Recipient's first name.</td><td><p></p><p>string(30)</p><ul><li>periods or other special characters</li><li>cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”</li><li>only alphanumeric values ​​are allowed</li><li>can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“</li><li>a hyphen or space can be inside, but not at the beginning or end</li><li>For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027</li></ul></td><td>No</td><td>Ivanenko</td></tr><tr><td><strong>recipientLastName</strong></td><td>Recipient's last name.</td><td><p></p><p>string(30)</p><ul><li>periods or other special characters</li><li>cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”</li><li>only alphanumeric values ​​are allowed</li><li>can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“</li><li>a hyphen or space can be inside, but not at the beginning or end</li><li>For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027</li></ul></td><td>No</td><td>Ivan</td></tr><tr><td><strong>recipientMiddleName</strong></td><td>Recipient's middle name.</td><td><p></p><p>string(30)</p><ul><li>periods or other special characters</li><li>cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”</li><li>only alphanumeric values ​​are allowed</li><li>can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“</li><li>a hyphen or space can be inside, but not at the beginning or end</li><li>For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027</li></ul></td><td>No</td><td>Ivanovich</td></tr><tr><td><strong>recipientEmail</strong></td><td>Recipient's email.</td><td>string(256)</td><td>No</td><td>mail@gmail.com</td></tr><tr><td><strong>recipientCountry</strong></td><td>Recipient's country (ISO 3166, 804 for Ukraine).</td><td>string(3)</td><td>No</td><td>804</td></tr><tr><td><strong>recipientRegion</strong></td><td>Recipient's region.</td><td>string(255)</td><td>No</td><td>Kyivska</td></tr><tr><td><strong>recipientCity</strong></td><td>Recipient's city.</td><td>string(25)</td><td>No</td><td>Kyiv</td></tr><tr><td><strong>recipientStreet</strong></td><td>Recipient's street address.</td><td>string(35)</td><td>No</td><td>Sichovykh Striltsiv</td></tr><tr><td><strong>recipientAdditionalAddress</strong></td><td>Additional recipient's address details.</td><td>string(255)</td><td>No</td><td>23</td></tr><tr><td><strong>recipientItn</strong></td><td><p>Recipient's tax identification number.</p><p></p><ul><li>If an individual has officially refused to receive a TIN, it is necessary to pass an alternative parameter - <strong><code>recipientPassport</code></strong> with the correct passport data of the recipient.</li></ul></td><td>string(20)</td><td>Yes, if <strong>recipientPassport</strong> is not specified</td><td>123456789</td></tr><tr><td><strong>recipientPassport</strong></td><td>Recipient's passport number.</td><td>string(255)</td><td>Yes, if <strong>recipientItn</strong> is not specified</td><td>AN123456</td></tr><tr><td><strong>recipientIp</strong></td><td>Recipient's IP address.</td><td>string(50)</td><td>No</td><td>123.12.12.12</td></tr><tr><td><strong>recipientPhone</strong></td><td>Recipient's phone number.</td><td>string(20)</td><td>No</td><td>380630000000</td></tr><tr><td><strong>recipientBirthday</strong></td><td>Recipient's birth date.</td><td>string(50)</td><td>No</td><td>31.12.2000</td></tr><tr><td><strong>recipientGender</strong></td><td>Recipient's gender.</td><td>string(50)</td><td>No</td><td>Male/Female</td></tr><tr><td><strong>recipientZipCode</strong></td><td>Recipient's postal code.</td><td>string(50)</td><td>No</td><td>49000</td></tr></tbody></table>

## **Output Parameters**

<table><thead><tr><th width="157">Parameter</th><th width="201">Description</th><th width="190">Data Format</th><th width="230">Example</th></tr></thead><tbody><tr><td>type</td><td>Transaction type</td><td>string</td><td>ACCOUNT_2_CARD</td></tr><tr><td>rrn</td><td>RRN transaction number in MPS</td><td>string</td><td>2554256963</td></tr><tr><td>purpose</td><td>Payment purpose</td><td>string</td><td>For goods</td></tr><tr><td>comment</td><td>Comment</td><td>string</td><td>test</td></tr><tr><td>coinAmount</td><td>Payment amount</td><td>int</td><td>2000</td></tr><tr><td>merchantId</td><td>Merchant ID</td><td>string</td><td>137d9304-0368-11ed-b939-0242ac120002</td></tr><tr><td>operationId</td><td>Transaction ID</td><td>string</td><td>1712844596346b9F-WwrWZpq</td></tr><tr><td>ecomOperationId</td><td>Transaction ID in Ecom system</td><td>string</td><td>8c3303e9-7396-43b8-af4e-31d9facdde9b</td></tr><tr><td>merchantName</td><td>Merchant name</td><td>string</td><td>KB test terminal</td></tr><tr><td>approvalCode</td><td>Authorization code</td><td>string</td><td>39203</td></tr><tr><td>status</td><td>Transaction status</td><td>string</td><td>SUCCESS FAIL PENDING REQUIRED_3DS DESIRED_THREEDS_MODE_ERROR</td></tr><tr><td>transactionType</td><td>Transaction type in numerical format</td><td>string</td><td>46</td></tr><tr><td>merchantRequestId</td><td>Merchant request ID</td><td>string</td><td>72837906-f526-4aef-8d11-58d80b44cb75</td></tr><tr><td>transactionCurrency</td><td>Payment currency</td><td>string</td><td>980</td></tr><tr><td>merchantCommission</td><td>Commission amount</td><td>string</td><td>2</td></tr><tr><td>createDateTime</td><td>Payment creation date</td><td>string</td><td>##########</td></tr><tr><td>modificationDateTime</td><td>Payment modification date</td><td>string</td><td>##########</td></tr><tr><td>actionCode</td><td>Response code</td><td>string</td><td>0</td></tr><tr><td>responseCode</td><td>Response details</td><td>string</td><td>0</td></tr><tr><td>description</td><td>Response description</td><td>string</td><td>approved</td></tr><tr><td>bankCode</td><td>Issuer bank name</td><td>string</td><td>BANK_ALLIANCE</td></tr><tr><td>paymentSystem</td><td>Issuer MPS name</td><td>string</td><td>MasterCard</td></tr><tr><td>productType</td><td>Terminal product type</td><td>string</td><td>A2C</td></tr><tr><td>notificationUrl</td><td>Callback notification URL</td><td>string</td><td>https://merchant.notification_url/</td></tr><tr><td>paymentServiceType</td><td>Payment type</td><td>string</td><td>CARD/APPLE_PAY/GOOGLE_PAY</td></tr><tr><td>notificationEncryption</td><td>Callback encryption flag</td><td>string</td><td>true/false If not provided or set to false, Callback data will be unencrypted</td></tr><tr><td>cardNumberMask</td><td>Masked card number</td><td>string</td><td>5573********0304</td></tr><tr><td>desiredThreeDSMode</td><td>Merchant preference for 3DS</td><td>string</td><td>MUST/SHOULD/MUST_NOT</td></tr><tr><td>threeDSMode</td><td>Indicates if 3DS was used</td><td>string</td><td>MUST - processed with 3DS, MUST_NOT - processed without 3DS</td></tr><tr><td>statusThreeDs</td><td>3DS transaction status</td><td>string</td><td>Y - successful, N - failed</td></tr><tr><td>threeDSServerTransId</td><td>Transaction ID in 3DS system</td><td>string</td><td>b6c35fdb-28c1-454d-a2f3-51098c26bda4</td></tr><tr><td>processingMerchantId</td><td>Merchant ID in processing center</td><td>string</td><td>AE100000</td></tr><tr><td>processingTerminalId</td><td>Terminal ID in processing center</td><td>string</td><td>AE100000</td></tr><tr><td>redirect3dsUrl</td><td>URL for client redirection to issuer page for 3DS authentication</td><td>string</td><td>https://api-ecom-release.develop.bankalliance.ua/threeDS/getRedirectHtml/1702047427621BHu5X99yDbA</td></tr><tr><td>txnType</td><td>Transaction subtype</td><td>enum</td><td>Possible values: NONCVV/noncvv - No CVV entry or verification required</td></tr><tr><td>Parameter</td><td>Description</td><td>Data Format</td><td>Example</td></tr><tr><td>senderCustomerId</td><td>Sender customer ID</td><td>string</td><td>1258728c1</td></tr><tr><td>senderFirstName</td><td>Sender first name</td><td>string</td><td>Ivanenko</td></tr><tr><td>senderLastName</td><td>Sender last name</td><td>string</td><td>Ivan</td></tr><tr><td>senderMiddleName</td><td>Sender middle name</td><td>string</td><td>Ivanovych</td></tr><tr><td>senderEmail</td><td>Sender email</td><td>string</td><td>mail@gmail.com</td></tr><tr><td>senderCountry</td><td>Sender country</td><td>string</td><td>Ukraine</td></tr><tr><td>senderRegion</td><td>Sender region</td><td>string</td><td>Kyivska</td></tr><tr><td>senderCity</td><td>Sender city</td><td>string</td><td>Kyiv</td></tr><tr><td>senderStreet</td><td>Sender street</td><td>string</td><td>Sichovykh Striltsiv</td></tr><tr><td>senderAdditionalAddress</td><td>Additional sender address details (floor, house number, apartment)</td><td>string</td><td>23</td></tr><tr><td>senderItn</td><td>Sender tax ID</td><td>string</td><td>123456789</td></tr><tr><td>senderPassport</td><td>Sender passport number</td><td>string</td><td>AN123456</td></tr><tr><td>senderIp</td><td>Sender IP address</td><td>string</td><td>123.12.12.12</td></tr><tr><td>senderPhone</td><td>Sender phone number</td><td>string</td><td>3,8063E+11</td></tr><tr><td>senderBirthday</td><td>Sender date of birth</td><td>string</td><td>31.12.2000</td></tr><tr><td>senderGender</td><td>Sender gender</td><td>string</td><td>M</td></tr><tr><td>senderZipCode</td><td>Sender ZIP code</td><td>string</td><td>12000</td></tr><tr><td>senderBankCode</td><td>Sender issuer bank name</td><td>string</td><td>BANK_ALLIANCE</td></tr><tr><td>senderPaymentSystem</td><td>Sender issuer MPS name</td><td>string</td><td>MasterCard</td></tr><tr><td>senderCardNumberMask</td><td>Masked sender card number</td><td>string</td><td>5573********0304</td></tr><tr><td>Parameter</td><td>Description</td><td>Data Format</td><td>Example</td></tr><tr><td>recipientCustomerId</td><td>Recipient customer ID</td><td>string</td><td>1258728c1</td></tr><tr><td>recipientFirstName</td><td>Recipient first name</td><td>string</td><td>Ivanenko</td></tr><tr><td>recipientLastName</td><td>Recipient last name</td><td>string</td><td>Ivan</td></tr><tr><td>recipientMiddleName</td><td>Recipient middle name</td><td>string</td><td>Ivanovych</td></tr><tr><td>recipientEmail</td><td>Recipient email</td><td>string</td><td>mail@gmail.com</td></tr><tr><td>recipientCountry</td><td>Recipient country</td><td>string</td><td>Ukraine</td></tr><tr><td>recipientRegion</td><td>Recipient region</td><td>string</td><td>Kyivska</td></tr><tr><td>recipientCity</td><td>Recipient city</td><td>string</td><td>Kyiv</td></tr><tr><td>recipientStreet</td><td>Recipient street</td><td>string</td><td>Sichovykh Striltsiv</td></tr><tr><td>recipientAdditionalAddress</td><td>Additional recipient address details (floor, house number, apartment)</td><td>string</td><td>23</td></tr><tr><td>recipientItn</td><td>Recipient tax ID</td><td>string</td><td>123456789</td></tr><tr><td>recipientPassport</td><td>Recipient passport number</td><td>string</td><td>AN123456</td></tr><tr><td>recipientIp</td><td>Recipient IP address</td><td>string</td><td>123.12.12.12</td></tr><tr><td>recipientPhone</td><td>Recipient phone number</td><td>string</td><td>3,8063E+11</td></tr><tr><td>recipientBirthday</td><td>Recipient date of birth</td><td>string</td><td>31.12.2000</td></tr><tr><td>recipientGender</td><td>Recipient gender</td><td>string</td><td>M</td></tr><tr><td>recipientZipCode</td><td>Recipient ZIP code</td><td>string</td><td>12000</td></tr><tr><td>recipientBankCode</td><td>Recipient issuer bank name</td><td>string</td><td>BANK_ALLIANCE</td></tr><tr><td>recipientPaymentSystem</td><td>Recipient issuer MPS name</td><td>string</td><td>MasterCard</td></tr><tr><td>recipientCardNumberMask</td><td>Masked recipient card number</td><td>string</td><td>5573********0304</td></tr></tbody></table>

## Example Request Body

```json

{
"encryptedCardNumber":"{{encryptedPanT}}",
"merchantId":"137d9304-0368-11ed-b939-0242ac120002",
"merchantRequestId":"{{requestUUIDT}}",
"purpose":"за товар",
"coinAmount": 120,
"notificationUrl":"https://api-ecom-prod.bankalliance.ua/mock",
"ecomComment": "string",
"senderAccount": "UA12305299260022119999",
"customerData": {
        "senderCustomerId": "1234567",
        "senderFirstName": "John",
        "senderLastName": "Doe",
        "senderMiddleName": "Fall",
        "senderEmail": "test@gmail.com",
        "senderCountry": "sender_country",
        "senderRegion": "sender_region",
        "senderCity": "sender_city",
        "senderStreet": "sender_street",
        "senderAdditionalAddress": "N 6",
        "senderItn": "12345",
        "senderPassport": "12345",
        "senderIp": "165.222.87.224",
        "senderPhone": "380967542344",
        "senderBirthday": "12/12/2000",
        "senderGender": "Male",
        "senderZipCode": "12345",
        "recipientCustomerId": "1234567",
        "recipientFirstName": "Yura",
        "recipientLastName": "Bura",
        "recipientMiddleName": "TestMiddle",
        "recipientEmail": "res@gmail",
        "recipientCountry": "804",
        "recipientRegion": "res_reg",
        "recipientCity": "res_dnipro",
        "recipientStreet": "res_street",
        "recipientAdditionalAddress": "res_addres",
        "recipientItn": "res_iin",
        "recipientPassport": "res_pasport",
        "recipientIp": "165.222.87.224",
        "recipientPhone": "380967542344",
        "recipientBirthday": "12/12/2000",
        "recipientGender": "Female",
        "recipientZipCode": "77777"
    },
"date": "{{currentdateT}}.00+00:00"
}
```

## Example of a response body

```json
{
    "type": "ACCOUNT_2_CARD",
    "rrn": "410208187340",
    "purpose": "за товар",
    "comment": null,
    "coinAmount": 120,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712822901491QtPAxAWOrrg",
    "ecomOperationId": "ff1ae4eb-d66d-467e-896d-01ed579bd040",
    "merchantName": null,
    "approvalCode": null,
    "status": "PENDING",
    "transactionType": 46,
    "merchantRequestId": "cf17607f-c1f8-4e8e-abb2-5fd1b3dd17ec",
    "transactionCurrency": "980",
    "merchantCommission": null,
    "createDateTime": "2024.09.19 15:29:25.675",
    "modificationDateTime": "2024.09.19 15:29:25.675",
    "transactionResponseInfo": {
        "actionCode": null,
        "responseCode": null,
        "description": "Операція успішна"
    },
    "bankCode": null,
    "paymentSystem": null,
    "productType": "A2C",
    "notificationUrl": "https://api-ecom-prod.bankalliance.ua/mock",
    "paymentServiceType": "CARD",
    "notificationEncryption": false,
    "senderAccount": "UA12305299260022119999",
    "recipientCardNumberMask": null,
    "senderCustomerId": null,
    "senderFirstName": "Petro",
    "senderLastName": "Petrenko",
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": "803",
    "senderRegion": null,
    "senderCity": "Kyiv",
    "senderStreet": "L.Ukrainki01",
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "recipientCustomerId": null,
    "recipientFirstName": "TestFirstname",
    "recipientLastName": "TestLastName",
    "recipientMiddleName": null,
    "recipientEmail": null,
    "recipientCountry": "803",
    "recipientRegion": null,
    "recipientCity": "Kyiv",
    "recipientStreet": "T. Shevchenka, 11",
    "recipientAdditionalAddress": null,
    "recipientItn": null,
    "recipientPassport": null,
    "recipientIp": null,
    "recipientPhone": null,
    "recipientBirthday": null,
    "recipientGender": null,
    "recipientZipCode": null,
    "recipientBankCode": null,
    "recipientPaymentSystem": null
}
```