AlliancePay
🇬🇧 English
🇬🇧 English
  • E Commerce platform AlliancePay v2.32.0
  • Authentication
  • Data Encryption
  • Authorization
  • Using an authorization token
  • Key Management Overview
    • PURCHASE Collection Example
    • A2C Collection Example
  • Payment methods H2H
    • PURCHASE
      • PURCHASE Request - Step 1
      • PURCHASE Request - Step 2
    • A2C
    • C2A
      • C2A Transaction Request - Step 1
      • C2A Transaction Request - Step 2
    • ApplePay decrypted
      • PURCHASE
        • Payment Processing Request - Step 1
        • Payment Processing Request - Step 2 (3DS)
      • C2A
        • C2A request Step 1
        • C2A request Step 2 (3DS)
    • ApplePay encrypted
      • Request aPay support on the page
      • Request to receive aPay merchant data
      • Merchant validation request
      • Session Establishment Request in aPay
      • Payment Processing Request
    • GooglePay™ decrypted
      • PURCHASE
        • Payment Processing Request - Step 1
        • Payment Processing Request - Step 2 (3DS)
      • C2A
        • C2A request Step 1
        • C2A request Step 2 (3DS)
    • GooglePay™ encrypted
      • Google Pay™ Documentation
      • Google Pay™ Support Request on the Page
      • Google Pay™ Merchant Data Retrieval Request
      • Payment request
    • REFUND
    • TOKEN
      • PURCHASE
        • Token payment request Step 1
        • 3DS token payment request Step 2
      • C2A
        • Token payment request Step 1
        • 3DS token payment request Step 2
      • Token Creation
      • Retrieve Token by CustomerId
      • Retrieve Token Data
      • Update Token Status
      • Token Statuses
    • Account Verification
      • Card Verification Request Step 1
      • Card verification request Step 2
    • Getting data
      • By OPERATION_ID
      • By merchantRequestId
    • Getting a balance
    • Callback
  • Payment methods HPP
    • PURCHASE
      • Creating an order
      • Receiving order data
    • REFUND
    • Callback
    • Order statuses
  • Dictionary
    • Transaction status
    • Test cases
    • Error codes
    • Value actionCode, responseCode
    • Limits
    • Instructions for reconciliation by registers
      • Fields Description in Registers
    • Whitelist IP addresses and URLs
  • History of changes
Powered by GitBook
On this page
  • Input Parameters:
  • Output Parameters:
  • Example Request Body
  • Example response body
  1. Payment methods H2H
  2. TOKEN
  3. C2A

3DS token payment request Step 2

{{url}}/ecom/execute_request/payments/v1/card_2_terminal/token_3ds

Input Parameters:

Parameter

Description

Data Format

Required

Example

operationId

Operation ID received in Step 1

string

Yes

137d9304-0368-11ed-b939-0242ac120002

date

Payment date and time

string

Yes

{{currentdateT}}.00+00:00

browserInfo

Browser-related data object

object

Yes, if 3DS required

browserAcceptHeader

HTTP request header

string

Yes, if 3DS required

text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,...

browserUserAgent

User agent string

string

Yes, if 3DS required

Mozilla/5.0 (Windows NT 10.0; Win64; x64)...

browserLanguage

Browser language

string

Yes, if 3DS required

en-US,en

browserColorDepth

Screen color depth

string

Yes, if 3DS required

24

browserScreenHeight

Browser window height

string

Yes, if 3DS required

800

browserScreenWidth

Browser window width

string

Yes, if 3DS required

1280

browserTZ

Browser timezone

string

Yes, if 3DS required

-180

Output Parameters:

Parameter

Description

Data Format

Example

type

Transaction type

string

CARD_2_ACCOUNT

rrn

Transaction RRN number in MPS

string

2554256963

purpose

Payment purpose

string

For goods

comment

Transaction comment

string

test

coinAmount

Payment amount

int

2000

merchantId

Merchant ID

string

137d9304-0368-11ed-b939-0242ac120002

operationId

Transaction ID

string

1712844596346b9F-WwrWZpq

ecomOperationId

Transaction ID in Ecom system

string

8c3303e9-7396-43b8-af4e-31d9facdde9b

merchantName

Merchant name

string

KB test terminal

approvalCode

Authorization code

string

39203

status

Transaction status

string

SUCCESS, FAIL, PENDING, REQUIRED_3DS, DESIRED_THREEDS_MODE_ERROR

transactionType

Transaction type (numeric)

string

62

merchantRequestId

Merchant request ID

string

72837906-f526-4aef-8d11-58d80b44cb75

transactionCurrency

Payment currency

string

980

merchantCommission

Merchant commission amount

string

2

createDateTime

Payment creation date and time

string

19.09.2024 15:29

modificationDateTime

Payment modification date and time

string

19.09.2024 15:29

actionCode

Response code

string

0

responseCode

Response details

string

0

description

Response description

string

approved

bankCode

Issuer bank name

string

BANK_ALLIANCE

paymentSystem

Issuer MPS name

string

MasterCard

productType

Terminal product type

string

C2A

notificationUrl

Callback notification URL

string

https://merchant.notification_url/

paymentServiceType

Payment type

string

CARD/APPLE_PAY/GOOGLE_PAY

notificationEncryption

Callback data encryption flag

string

true/false

cardNumberMask

Masked card number

string

5573********0304

desiredThreeDSMode

Merchant preference for 3DS usage

string

MUST/SHOULD/MUST_NOT

threeDSMode

Whether 3DS was used

string

MUST, MUST_NOT

statusThreeDs

3DS transaction status

string

Y, N

threeDSServerTransId

3DS system transaction ID

string

b6c35fdb-28c1-454d-a2f3-51098c26bda4

redirect3dsUrl

URL for client redirection for 3DS authentication

string

https://api-ecom-release.develop.bankalliance.ua/threeDS/getRedirectHtml/...

txnType

Transaction subtype.

enum

NONCVV/noncvv

customerData

Object containing customer details.

object

-

senderCustomerId

Sender's customer ID.

string (255)

1258728c1

senderFirstName

Sender's first name.

​

string(30)

Ivanenko

senderLastName

Sender's last name.

​

string(30)

Ivan

senderMiddleName

Sender's middle name.

​

string(30)

Ivanovich

senderEmail

Sender's email.

string (256)

mail@gmail.com

senderCountry

Sender's country.

string (3) ISO 3166

804

senderRegion

Sender's region.

string (255)

Kyivska

senderCity

Sender's city.

string (25)

Kyiv

senderStreet

Sender's street.

string (35)

Sichovykh Striltsiv

senderAdditionalAddress

Additional address data (floor, house number, apartment).

string (255)

23

senderItn

Sender's tax ID.

string (20)

123456789

senderPassport

Sender's passport.

string (255)

AN123456

senderIp

Sender's IP address.

string (50)

123.12.12.12

senderPhone

Sender's phone number.

string (20)

3,81E+11

senderBirthday

Sender's date of birth.

string (50)

31.12.2000

senderGender

Sender's gender.

string (50)

Male/Female

senderZipCode

Sender's postal code.

string (50)

49000

recipientCustomerId

Recipient's client id

​string(30)

1258728c1

recipientFirstName

Recipient's first name

​string(30)

Ivanenko

recipientLastName

Recipient's last name

​string(30)

Ivan

recipientMiddleName

Recipient's middle name

string(30)

Ivanovich

recipientEmail

Recipient's email

string

mail@gmail.com

recipientСountry

Recipient's county

string

804

recipientRegion

Recipient's region

string

Kyivska

recipientСity

Recipient's city

string

Kyiv

recipientStreet

Recipient's street

string

Sichovykh Striltsiv

recipientAdditionalAddress

Recipient's additional address data (floor, house number, apartment).

string

23

recipientItn

Recipient's tax ID.

string

123456789

recipientPassport

Recipient's passport

string

AN123456

recipientIp

Recipient's IP address.

string

123.12.12.12

recipientPhone

Recipient's phone number

string

3,81E+11

recipientBirthday

Recipient's date of birth.

string

31.12.2000

recipientGender

Recipient's gender

string

Male/Female

recipientZipCode

Recipient's zip code

string

49000

recipientBankCode

Recipient's issuing bank

string

BANK_ALLIANCE

recipientPaymentSystem

Recipient's payment system

string

MasterCard

recipientCardNumberMask

Recipient's masked card number

string

5573********0304

externalCardToken

token id

string

tmkEYenZSa8FV03aawVXxbep

Example Request Body

{
    "operationId": "{{operationIdT}}",
    "browserInfo": {
        "browserAcceptHeader": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9",
        "browserUserAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like,Gecko)Chrome/87.0.4280.66 Safari/537.36",
        "browserLanguage": "en-US,en",
        "browserColorDepth": "24",
        "browserScreenHeight": "800",
        "browserScreenWidth": "1280",
        "browserTZ": "-180"
    },
    "date": "{{currentdateT}}.00+00:00"
}

Example response body

{
    "type": "CARD_2_ACCOUNT",
    "rrn": null,
    "purpose": "purpose",
    "comment": "comment",
    "coinAmount": 1010,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712823334404zicRAYWIAm1",
    "ecomOperationId": "412ac336-aac5-43b5-8d35-b57ffa9d53ff",
    "merchantName": null,
    "approvalCode": null,
    "status": "REQUIRED_3DS",
    "transactionType": 62,
    "merchantRequestId": "60cb4f84-add5-48c6-984f-7b20a6b50c75",
    "transactionCurrency": "980",
    "merchantCommission": 67,
    "createDateTime": "2024.09.19 15:29:25.675",
    "modificationDateTime": "2024.09.19 15:29:25.675",
    "transactionResponseInfo": {
        "actionCode": null,
        "responseCode": null,
        "description": null
    },
    "bankCode": null,
    "paymentSystem": null,
    "productType": "C2A",
    "paymentServiceType": "CARD",
    "notificationEncryption": false,
    "senderCardNumberMask": null,
    "desiredThreeDSMode": "MUST",
    "threeDSMode": "MUST",
    "statusThreeDs": null,
    "threeDSServerTransId": "db259063-61ba-4681-a7e9-65fbbebead2d",
    "redirect3dsUrl": "https://api-ecom-release.develop.bankalliance.ua/threeDS/getRedirectHtml/1712823334404zicRAYWIAm1",
    "recipientAccount": null,
    "senderCustomerId": null,
    "senderFirstName": "FirstName",
    "senderLastName": "Name",
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": "Ukraine",
    "senderRegion": null,
    "senderCity": "City",
    "senderStreet": "Str.",
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "recipientCustomerId": null,
    "recipientFirstName": null,
    "recipientLastName": null,
    "recipientMiddleName": null,
    "recipientEmail": null,
    "recipientCountry": null,
    "recipientRegion": null,
    "recipientCity": null,
    "recipientStreet": null,
    "recipientAdditionalAddress": null,
    "recipientItn": null,
    "recipientPassport": null,
    "recipientIp": null,
    "recipientPhone": null,
    "recipientBirthday": null,
    "recipientGender": null,
    "recipientZipCode": null,
    "externalCardToken": "tmkEYenZSa8FV03aawVXxbep"
}
PreviousToken payment request Step 1NextToken Creation

Last updated 2 months ago