Calculate authorization amount

POST

https://api.zen.com/v1/authorization/calculate

Authorization parameter is used in a couple of processes in ZEN. In this case for authorization fee process (allows to charging of transaction costs to the customer) and DCC (dynamic currency change) process.

To use authorizationfee parameter Merchant has to have feature activated. Then, it is possible to display the commission amount on the checkout, which will be charged to the customer for processing the transaction. The amount charged to the customer (added to the base transaction amount) will be returned to the Merchant. The parameter authorizationfee does not exclude charging the fee to the Merchant for processing the transaction.

It is possible to set authorizationfee parameter for one, some or all payment channels.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Basic Auth

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Header Params

Body Params application/jsonRequired

Example

{
    "merchantTransactionId": "string",
    "amount": "string",
    "currency": "string",
    "authorizationCurrency": "string",
    "transactionType": "TRT_PURCHASE",
    "ip": "127.0.0.1",
    "data": [
        {
            "routingCode": "GCVPLA219",
            "paymentMethod": "PME_CARD",
            "paymentChannel": "PCL_CARD",
            "cardOrganization": "COR_VISA",
            "cardBin": "string",
            "cardId": "f16ba382-eb42-481a-b08f-c57bdc9aae24"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.zen.com/v1/authorization/calculate' \
--header 'request-id;' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "merchantTransactionId": "string",
    "amount": "string",
    "currency": "string",
    "authorizationCurrency": "string",
    "transactionType": "TRT_PURCHASE",
    "ip": "127.0.0.1",
    "data": [
        {
            "routingCode": "GCVPLA219",
            "paymentMethod": "PME_CARD",
            "paymentChannel": "PCL_CARD",
            "cardOrganization": "COR_VISA",
            "cardBin": "string",
            "cardId": "f16ba382-eb42-481a-b08f-c57bdc9aae24"
        }
    ]
}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

[
    {
        "paymentMethod": "string",
        "maxFee": "string",
        "channels": [
            {
                "paymentChannel": "string",
                "cardOrganizations": [
                    {
                        "cardId": "string",
                        "organization": "string",
                        "authorization": {
                            "fee": "string",
                            "amount": "string",
                            "baseAmount": "string",
                            "currency": "string",
                            "rate": "string",
                            "rateExpireAt": "string"
                        }
                    }
                ],
                "authorization": {
                    "fee": "string",
                    "amount": "string",
                    "baseAmount": "string",
                    "currency": "string",
                    "rate": "string",
                    "rateExpireAt": "string"
                }
            }
        ]
    }
]

🟠404Record Not Found

🟠422

🔴500

Modified at 2026-07-29 09:41:49

Removes merchant customer payout card.

Calculate reversed authorization amount