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 of a request body
  • Example of response body without 3DS
  • Example response body from 3DS
  1. Payment methods H2H
  2. GooglePay™ encrypted

Payment request

{{url}}/ecom/execute_request/payments/v1/google_pay/token/purchase

Input parameters:

Parameter
Description
Data Format
Required
Example

googlePayPaymentData

Main object containing Google Pay payment data

JSON object

Yes

{ ... }

apiVersion

Google Pay API version

int

Yes

2

apiVersionMinor

API minor version

int

Yes

0

paymentMethodData

Payment method details

JSON object

Yes

{ ... }

description

Payment method description

string

Yes

"Mastercard •••• 9079"

info

Additional card details

JSON object

Yes

{ ... }

assuranceDetails

Card verification details

JSON object

Yes

{ ... }

accountVerified

Indicates if the account is verified

boolean

Yes

TRUE

cardHolderAuthenticated

Indicates if the cardholder is authenticated

boolean

Yes

FALSE

cardDetails

Last four digits of the card

string

Yes

"9079"

cardNetwork

Card payment network

string

Yes

"MASTERCARD"

tokenizationData

Tokenization details

JSON object

Yes

{ ... }

token

Payment token

string

Yes

"{...}"

type

Tokenization type (e.g., payment gateway)

string

Yes

"PAYMENT_GATEWAY"

merchantInfo

Merchant information

JSON object

Yes

{ ... }

merchantId

Merchant identifier

string

Yes

"1234567890"

gateway

Payment gateway name

string

Yes

"timeproject"

environment

Environment (TEST/PRODUCTION)

string

Yes

"TEST"

merchantRequestId

Unique request identifier generated by the merchant's system

string (36)

Yes

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

merchantId

Merchant ID generated in Ecom

string(36)

Yes

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

transactionAmount

Payment amount in minor currency units (e.g., cents)

string

Yes

2000

desiredThreeDSMode

Merchant's preference for 3DS authentication

string (50)

Yes

Default: "SHOULD"

resultRedirectUrl

URL for client redirection after 3DS authentication

string (1000)

No

"Google Help"

notificationUrl

Callback notification URL

string (1000)

No

"https://merchant.notification_url"

notificationEncryption

Indicates if callback data should be encrypted

string

No

true/false

date

Payment date and time

string

Yes

{{currentdateT}}.00+03:00

comment

Additional transaction description by the merchant's client

string (1000)

No

"///5555.25412"

purpose

Payment purpose specified by the merchant

string (255)

No

"For goods"

merchantComment

Additional merchant comment on the order

string(255) a-zA-Z0-9 ,.;:@#$%'-=+1,256$

No

"merchant Comment id 1258728c1"

customerData

Customer data object

object

Yes

{ ... }

senderCustomerId

Sender's customer ID.

string(255)

Yes

1258728c1

senderFirstName

Sender's first name.

string(30)

  • the value cannot contain only numbers

  • cannot contain periods or other special characters

  • cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”

  • only alphanumeric values ​​are allowed

  • can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“

  • a hyphen or space can be inside, but not at the beginning or end

  • For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027

No

Ivanenko

senderLastName

Sender's last name.

string(30)

  • the value cannot contain only numbers

  • cannot contain periods or other special characters

  • cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”

  • only alphanumeric values ​​are allowed

  • can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“

  • a hyphen or space can be inside, but not at the beginning or end

  • For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027

No

Ivan

senderMiddleName

Sender's middle name.

string(30)

  • the value cannot contain only numbers

  • cannot contain periods or other special characters

  • cannot contain “NULL”, “3D SECURE”, “SURNAME”, “CARDHOLDER”, ”UNKNOWN”

  • only alphanumeric values ​​are allowed

  • can accept a space and a hyphen, but can NOT consist exclusively of “ ” or “-“

  • a hyphen or space can be inside, but not at the beginning or end

  • For the apostrophe character, use the only available utf8 character - ' which in: utf 16 - u0027 utf32 - 00000027

No

Ivanovich

senderEmail

Sender's email.

string(256)

No

mail@gmail.com

senderCountry

Sender's country code.

string(3) (ISO 3166, e.g., 804 for Ukraine)

No

804

senderRegion

Sender's region.

string(255)

No

Kyivska

senderCity

Sender's city.

string(25)

No

Kyiv

senderStreet

Sender's street.

string(35)

No

Sichovykh Striltsiv

senderAdditionalAddress

Additional sender address details (floor, house number, apartment).

string(255)

No

23

senderItn

Sender's tax identification number.

string(20)

No

1,20E+08

senderPassport

Sender's passport number.

string(255)

No

AN123456

senderIp

Sender's IP address.

string(50)

No

123.12.12.12

senderPhone

Sender's phone number.

string(20)

No

3,80E+11

senderBirthday

Sender's date of birth.

string(50)

No

########

senderGender

Sender's gender.

string(50)

No

Male

senderZipCode

Sender's postal code.

string(50)

No

49000

Output parameters:

Parameter

Description

Data Format

Example

type

Transaction type.

string

Purchase

rrn

RRN transaction number in MPS.

string

2,55E+09

purpose

Payment purpose.

string

For goods

comment

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 the Ecom system.

string

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

merchantName

Merchant name.

string

KB test terminal

approvalCode

Authorization code.

string

39203

status

Transaction status.

string

Possible values: SUCCESS, FAIL, PENDING, REQUIRED_3DS, DESIRED_THREEDS_MODE_ERROR

transactionType

Transaction type in numerical form.

string

35

merchantRequestId

Merchant request id

string

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

transactionCurrency

Payment currency.

string

980

merchantCommission

Commission amount

string

2

createDateTime

Transaction creation date.

string

########

modificationDateTime

Transaction modification date.

string

########

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

PURCHASE

notificationUrl

URL to which the CallBack is sent

string

paymentServiceType

Payment type

string

CARD/APPLE_PAY/GOOGLE_PAY

notificationEncryption

Callback data encryption feature

string

true/false If the parameter is not passed or false is passed, then the data in the CallBack will be unencrypted

cardNumberMask

Masked card number

string

5573********0304

desiredThreeDSMode

A feature that indicates whether the merchant wants to use the 3DS in the purchase or not.

string

MUST/SHOULD/MUST_NOT

threeDSMode

A parameter that indicates whether a 3DS is used in the purchase or not

string

MUST- pay with 3DS MUST_NOT- pay without 3DS

statusThreeDs

3DS holding status

string

Y - successful 3ds N - unsuccessful 3ds

threeDSServerTransId

Id of the transaction in the 3ds system

string

8a811df4-91e0-436b-a9ac-9b0772c96f28

acsTransId

Id of the transaction in the ACS system

string

3e17fabb-71e6-498e-8794-ef8c95c5ba6f

dsTransId

Transaction ID generated by Directory Server

string

12ebc556-82d3-4e35-9fb8-77ac18b050ea

eci

Electronic Commerce Indicator A code that indicates the security level of a transaction

string

2

processingMerchantId

Id of the merchant in PC

string

AE100000

processingTerminalId

Id of the terminal in the PS

string

AE100000

redirect3dsUrl

URL to redirect the client to the issuer's page for the 3DS pass

string

txnType

Under the type of transaction

enum

Possible values: NONCVV/noncvv- upon receipt of a given value of cvv input and its verification does not occur

senderCustomerId

Id of the sender's client

string

1258728c1

senderFirstName

Sender's first name

string

Ivanenko

senderLastName

Sender's last name

string

Ivan

senderMiddleName

Sender's middle name

string

Ivanovich

senderEmail

Sender's mail

string

mail@gmail.com

senderCountry

Sender's country

string

Ukraine

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

1,23E+08

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

########

recipientGender

Recipient's gender

string

Male/Female

recipientZipCode

Recipient's zip code

string

49000

senderBankCode

Sender's issuing bank

string

BANK_ALLIANCE

senderPaymentSystem

Sender's issuer

string

MasterCard

senderCardNumberMask

Masked card number of the sender

string

5573********0304

Example of a request body

{
    "googlePayPaymentData": {
        "apiVersion": 2,
        "apiVersionMinor": 0,
        "paymentMethodData": {
            "description": "Mastercard •••• 9079",
            "info": {
                "assuranceDetails": {
                    "accountVerified": true,
                    "cardHolderAuthenticated": false
                },
                "cardDetails": "9079",
                "cardNetwork": "MASTERCARD"
            },
            "tokenizationData": {
                "token": "{\"signature\":\"MEUCIQDaNH5qORDmyWCADBPPQdx0WLGzqP4l9gznr1P0C92JQIgcCC5sGVaHKcopWwx9qMQ+nJswxyk5LugcQng8cUQKPs\\u003d\",\"intermediateSigningKey\":{\"signedKey\":\"{\\\"keyValue\\\":\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE/uMFvqw3uWfiJfev8mveNhiQcRSVSzqynD1jo/WAKA1iXtyyoty/uzQBbRhFmnwRxRWJvSJiVe8Q3aMEePajgA\\\\u003d\\\\u003d\\\",\\\"keyExpiration\\\":\\\"1732261522591\\\"}\",\"signatures\":[\"MEUCIEr2AORUfr3tThPtgNAmtXX3kMXlxqQE5HfzFf/qCt5FAiEArM2taQdIa+t2ug2GxaXo7so9CcVSAXe5vfo/AATvHuU\\u003d\"]},\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"jOTMB2WrbkP7mV2PzNrz8TDM0vgoyfLfL5MoqkfyzNP1bSr5agnuxaTOH6zdUVNcqM1tI45H8/vZvMA7Atqk05iUteWMbMS8jcHdwbOXqXdHAmK2keUBJ1+WltKDfdcldTqRCVUbkb2zEOPS9O7x97EKshGcdOFMgy3rWkSDHOGYI2iU4fcu780LkZ2S9qOiQxugF77HyWF+R6eY6YONMftw1dbyLlifz1NQkRqiVuWZfY1haBFS54P23PTPg/z8LEndY/34DoHSPbErxtaweu5mzZmFhCvaNSurjdUQSG9ZnrRFS4sBsMDkdnKgtuDl/Dp8DWoKDGQ5N1KQHK6I429r5HQzGvZI/mpLGXjLS/IqKPYail0xFbQt/sKKJWslMuzgtPLdwOGJOaC3EiS9ASy7Xwjfsy8kmZiCMH0J6XFbDQPW1nYupMkCNmQbmV0xUhkPX1meGmJ/gGYw+r/c6NtQfBoU+pfaQUOuMPU5swdlArtCdfKve0NkPTgvXErz6sLwB/WTv1iWknescQC2skne7d3KUE5dQsUIKWDtlbStAZwHfRC9SrhqA9OF8Q\\\\u003d\\\\u003d\\\",\\\"ephemeralPublicKey\\\":\\\"BCWiEFk24pBKXyporPbi4AAqbKJNa9kV1XDAwJHxCkyDFwZaGKzdpgFfuOVXgZTOREohQXSowPvp+7Cf9Zq9xTI\\\\u003d\\\",\\\"tag\\\":\\\"7aO3dd8BrbM0xYGd8rlAdOEeUiT+vXYxCXedIM9nw/w\\\\u003d\\\"}\"}",
                "type": "PAYMENT_GATEWAY"
            },
            "type": "CARD"
        },
        "merchantInfo": {
            "merchantId": "1234567890",
            "gateway": "timeproject"
        }
    },
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "environment": "TEST",
    "resultRedirectUrl": "137d9304-0368-11ed-b939-0242ac120002",
    "notificationEncryption": false,
    "notificationUrl": "https://eocfzhqbfuebmke.m.pipedream.net",
    "merchantRequestId": "1df6672b-d198-469d-88ce-6dab74d7feb2",
    "coinAmount": 1000,
    "customerData": {
        "senderCustomerId": "34234234",
        "senderCountry": "234"
    },
    "comment": "comment",
    "purpose": "purpose",
    "desiredThreeDSMode": "MUST_NOT",
    "date": "2024-11-15 14:13:50.00+03:00",
    "merchantComment": "resultRedirectUrl",
    "browserInfo": {
        "browserAcceptHeader": "text/html,application/xhtmlxml,application/xml;q=0.9,image/avif,imagewebp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9",
        "browserUserAgent": "Mozilla/5.0(WindowsNT10.0;Win64;x64)AppleWebKit/537.36(KHTML,like,Gecko)Chrome/87.0.4280.66Safari/537.36",
        "browserLanguage": "en-US,en",
        "browserColorDepth": "24",
        "browserScreenHeight": "800",
        "browserScreenWidth": "1280",
        "browserTZ": "-180"
    }
}

Example of response body without 3DS

{
    "type": "PURCHASE",
    "rrn": "410211187850",
    "purpose": "purpose",
    "comment": "comment",
    "coinAmount": null,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "1712836451574mxQBagrb76l",
    "ecomOperationId": "7fb11c16-918d-4bfb-83aa-00e7a8576f9c",
    "merchantName": null,
    "approvalCode": null,
    "status": "SUCCESS",
    "transactionType": 35,
    "merchantRequestId": "9a89759c-f500-461f-a0c7-69a5b678b89d",
    "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": "PURCHASE",
    "notificationUrl": "https://api-ecom-prod.bankalliance.ua/mock",
    "paymentServiceType": "GOOGLE_PAY",
    "notificationEncryption": false,
    "cardNumberMask": null,
    "desiredThreeDSMode": "MUST_NOT",
    "threeDSMode": "MUST_NOT",
    "statusThreeDs": null,
    "threeDSServerTransId": null,
    "redirect3dsUrl": null,
    "txnType": "null",
    "senderCustomerId": null,
    "senderFirstName": null,
    "senderLastName": null,
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": null,
    "senderRegion": null,
    "senderCity": null,
    "senderStreet": null,
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "senderCardNumberMask": null
}

Example response body from 3DS

{
    "type": "PURCHASE",
    "rrn": null,
    "purpose": "purpose",
    "comment": "comment",
    "coinAmount": null,
    "merchantId": "137d9304-0368-11ed-b939-0242ac120002",
    "operationId": "17128429092802o9koN8eABn",
    "ecomOperationId": "99261a33-cfae-4dfa-9396-812817b5dffb",
    "merchantName": null,
    "approvalCode": null,
    "status": "REQUIRED_3DS",
    "transactionType": 35,
    "merchantRequestId": "8bf3bc51-53e8-4d12-9e86-c13dd6af3b9e",
    "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": null
    },
    "bankCode": null,
    "paymentSystem": null,
    "productType": "PURCHASE",
    "notificationUrl": "https://webhook.site/cbf8c83a-ee1e-47c6-899c-eca5731ff084",
    "paymentServiceType": "GOOGLE_PAY",
    "notificationEncryption": false,
    "cardNumberMask": null,
    "desiredThreeDSMode": "MUST",
    "threeDSMode": "MUST",
    "statusThreeDs": null,
    "threeDSServerTransId": "5d175446-df26-4ad0-a60c-cd8f95570c0c",
    "redirect3dsUrl": null,
    "txnType": "null",
    "senderCustomerId": null,
    "senderFirstName": null,
    "senderLastName": null,
    "senderMiddleName": null,
    "senderEmail": null,
    "senderCountry": null,
    "senderRegion": null,
    "senderCity": null,
    "senderStreet": null,
    "senderAdditionalAddress": null,
    "senderItn": null,
    "senderPassport": null,
    "senderIp": null,
    "senderPhone": null,
    "senderBirthday": null,
    "senderGender": null,
    "senderZipCode": null,
    "senderBankCode": null,
    "senderPaymentSystem": null,
    "senderCardNumberMask": null
}
PreviousGoogle Pay™ Merchant Data Retrieval RequestNextREFUND

Last updated 2 months ago

​https://merchant.notification_url/​
​https://api-ecom-release.develop.bankalliance.ua/threeDS/getRedirectHtml/1702047427621BHu5X99yDbA​