Card Transaction Authorization Relay

Developing

POST

${authorization-relay.endpoint}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Example

{
    "id": "CTXM123456",
    "type": "AUTHORIZATION_REQUEST",
    "transactionId": "CTX123456",
    "transactionType": "PURCHASE",
    "cardId": "CA123456",
    "cardholderId": "CH123456",
    "cardCurrency": "EUR",
    "cardBrand": "VISA",
    "cardBin": "41506500",
    "cardPanLast4Digits": "0528",
    "cardVirtualAccount": {
        "id": "AC123456",
        "groupCode": "EUR20",
        "currency": "EUR"
    },
    "cardFundingAccount": {
        "id": "AC123456",
        "groupCode": "EUR20",
        "currency": "EUR"
    },
    "authorizationRelayUrl": "https://auth-relay.example.com",
    "billingCurrency": "EUR",
    "billingAmount": "10.00",
    "billingMarkupAmount": "0.00",
    "billingFeeAmount": "0.00",
    "transactionCurrency": "EUR",
    "transactionAmount": "10.00",
    "transactionTime": "2026-01-01T00:00:00Z",
    "merchant": {
        "mcc": "4111",
        "id": "CARD ACCEPTOR",
        "name": "ACQUIRER NAME",
        "locationCountryCode": "FR",
        "locationCity": "Paris",
        "locationStreet": "TowerE, Abc Street",
        "locationPostalCode": "C2A 2EX",
        "terminalId": "TERMID01",
        "descriptor": "CARD ACCEPTOR"
    },
    "entryMode": "1005",
    "networkSettlementUtilityNumber": "006335",
    "authorizationCode": "SGVHW2",
    "cardNetworkAuthorizationCode": "FKUHSJ3",
    "banknetReferenceNumber": "316120082886336",
    "createdTime": "2026-01-01T00:00:00Z",
    "updatedTime": "2026-01-01T00:00:00Z"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '$https://auth-relay.example.com' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "id": "CTXM123456",
    "type": "AUTHORIZATION_REQUEST",
    "transactionId": "CTX123456",
    "transactionType": "PURCHASE",
    "cardId": "CA123456",
    "cardholderId": "CH123456",
    "cardCurrency": "EUR",
    "cardBrand": "VISA",
    "cardBin": "41506500",
    "cardPanLast4Digits": "0528",
    "cardVirtualAccount": {
        "id": "AC123456",
        "groupCode": "EUR20",
        "currency": "EUR"
    },
    "cardFundingAccount": {
        "id": "AC123456",
        "groupCode": "EUR20",
        "currency": "EUR"
    },
    "authorizationRelayUrl": "https://auth-relay.example.com",
    "billingCurrency": "EUR",
    "billingAmount": "10.00",
    "billingMarkupAmount": "0.00",
    "billingFeeAmount": "0.00",
    "transactionCurrency": "EUR",
    "transactionAmount": "10.00",
    "transactionTime": "2026-01-01T00:00:00Z",
    "merchant": {
        "mcc": "4111",
        "id": "CARD ACCEPTOR",
        "name": "ACQUIRER NAME",
        "locationCountryCode": "FR",
        "locationCity": "Paris",
        "locationStreet": "TowerE, Abc Street",
        "locationPostalCode": "C2A 2EX",
        "terminalId": "TERMID01",
        "descriptor": "CARD ACCEPTOR"
    },
    "entryMode": "1005",
    "networkSettlementUtilityNumber": "006335",
    "authorizationCode": "SGVHW2",
    "cardNetworkAuthorizationCode": "FKUHSJ3",
    "banknetReferenceNumber": "316120082886336",
    "createdTime": "2026-01-01T00:00:00Z",
    "updatedTime": "2026-01-01T00:00:00Z"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "approved": "false",
    "declinedReason": "INSUFFICIENT_BALANCE",
    "description": "Insufficient cardholder balance"
}

Modified at 2026-05-20 06:14:52

Query Card PIN

Query Card Transaction Message