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

Header Params

Body Params application/jsonRequired

Example

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

Responses

🟢200OK

application/json

Body

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

Modified at 2025-11-10 07:13:37

Removes merchant customer payout card.

Calculate reversed authorization amount