Cross-border Requests

Create a Cross-border Quote

Changed on

Obtain a single-use quote using senderAmount, senderCurrency and receiverCurrency. Match the request's exact source amount and currencies. Save data.id as quoteId, display the returned amounts and fee, and use expiresAt in Unix milliseconds. receiverAmount is after the fee deduction; do not deduct it again or compute it from exchangeRate. This call does not create a request or initiate a payment. Sandbox uses the same suffix under /api/sandbox/b2b/cross-border/requests with a sandbox bearer token.

post/api/b2b/cross-border/requests/quotes

Request

  • Base URL
    https://api-v2.honeycoin.app
  • URL
    https://api-v2.honeycoin.app/api/b2b/cross-border/requests/quotes
  • Auth
    API key in header Authorization

Request body

senderAmountnumber required

Match the request's senderAmount, originally supplied as amount.

senderCurrency'KES' | 'NGN' required

Match the request's senderCurrency, originally supplied as chargeCurrency.

receiverCurrency'CNY' required

Match the request's receiverCurrency.

Response

Successful response.

successtrue required

Changes