Mock Card Transaction Authorization Message

Developing

POST

/mock/card-transaction/authorization-message

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Example

{
    "transactionType": "PURCHASE",
    "cardId": "CA123456",
    "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"
    },
    "transactionCurrency": "EUR",
    "transactionAmount": 10,
    "billingAmount": 10,
    "entryMode": "1005",
    "advice": true,
    "approved": false,
    "description": "Insufficient balance"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/mock/card-transaction/authorization-message' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "transactionType": "PURCHASE",
    "cardId": "CA123456",
    "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"
    },
    "transactionCurrency": "EUR",
    "transactionAmount": 10,
    "billingAmount": 10,
    "entryMode": "1005",
    "advice": true,
    "approved": false,
    "description": "Insufficient balance"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{
    "id": "CTXM123456",
    "originalMessageId": "CTXM123457",
    "type": "AUTHORIZATION",
    "transactionId": "CTX123456",
    "transactionType": "PURCHASE",
    "cardId": "CA123456",
    "cardholderId": "CH123456",
    "cardCurrency": "EUR",
    "cardBrand": "VISA",
    "cardBin": "41506500",
    "cardPanLast4Digits": "0528",
    "billingCurrency": "EUR",
    "billingAmount": "10.00",
    "billingMarkupAmount": "0.00",
    "billingFeeAmount": "0.00",
    "transactionCurrency": "EUR",
    "transactionAmount": "10.00",
    "clearingTransactionAmount": "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",
    "status": "DECLINED",
    "declinedReason": "CUSTOMER_AUTHORIZATION_RELAY_DECLINED",
    "customerDeclinedReason": "INSUFFICIENT_BALANCE",
    "advice": "true",
    "adviceReason": "Insufficient balance",
    "description": "Insufficient card virtual account available balance",
    "pendingReason": "System error",
    "settlementDate": "2026-01-02",
    "reconciliationDate": "2026-01-02",
    "createdTime": "2026-01-01T00:00:00Z",
    "updatedTime": "2026-01-01T00:00:00Z"
}

Modified at 2026-06-17 05:44:40

Card Transaction Authorization Relay

Mock Card Transaction Auth Additional