Calculate receiving amount

POST

/remit-api/v1/transactions/calculate-receiving-amount

This API endpoint calculates and retrieves the receiving amount based on the sending amount. The transaction type is optional; if provided, the API will return the receiving amount in the currency associated with the specified transaction type. If the transaction type is not provided, the API will return the receiving amount for all available currencies.

Request Params

Parameter	Type	Mandatory	Remarks
amount_usd	Integer	Y	This is the amount being sent and needs to be used for calculating the corresponding receiving amount.
transaction_type	Integer	N	The transaction type 1- Cash 2 - Account Credit 3 - Wallet 4 -Credit/Debit Card

Response Params

SI No	Parameter	Remarks
1	currency_code	the receiving currency
2	amount	the receiving amount

Request

Authorization

Header Params

Body Params application/json

Example

{
    "amount_usd":XXXX,
    "transaction_type":X
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://gateway-sandbox.balad.tech/remit-api/v1/transactions/calculate-receiving-amount' \
--header 'Content-Type: application/json' \
--data '{
    "amount_usd":XXXX,
    "transaction_type":X
}'

Responses

🟢200EG Country

application/json

Bodyapplication/json

Example

{
    "data": [
        {
            "currency_code": "EGP",
            "amount":XXX
        },
        {
            "currency_code": "USD",
            "amount":XXX
        }
    ],
    "errors": null
}

Export Transactions List

Validate Account