The Order Fee endpoint allows you to retrieve the transaction fee for a payment. This is useful for showing customers the exact cost or calculating the total amount before completing a payment.

💡
Good to know

You must encrypt the payload using RSA encryption (PKCS#1 v1.5).

Use this API to determine how much extra fee will be added based on the amount, currency, and payment method.

Headers

Header	Value	Description
`api-key`	`{{your_secret_key}}`	Your TransactPay secret key

Payload Structure (before encryption)

Key	Type	Description	Required
`amount`	`number`	The amount of the order	✅
`currency`	`string`	Currency code (e.g., `USD`, `NGN`)	✅
`paymentoption`	`string`	Payment method (e.g., `C`, `Opay`, `bank-transfer`)	✅

Sample Payload (before encryption)


{
  "amount": 100,
  "currency": "USD",
  "paymentoption": "C"
}

Encrypted Payload (what you send)


{
  "data": "{{encrypteddata}}"
}

Sample Success Response


{
  "status": "success",
  "message": "Fee retrieved",
  "data": {
    "amount": 100,
    "fee": 2.5,
    "total": 102.5,
    "currency": "USD"
  }
}

{
    "data": "{{encrypteddata}}"
}