HOhoneycoin
Cross-border Requests

Initiate a Cross-border Charge

Changed on

Initiate collection using saved chargeDetails and a JSON body containing a confirmed quoteId. The quote must be unused, unexpired, belong to the same account and environment, and match the request's senderAmount, senderCurrency and receiverCurrency. Only pending_charge or charge_failed requests without a pending or successful deposit are eligible. Document states block charging. Quotes are single-use; reconcile an uncertain response and obtain a fresh quote for an eligible new attempt. Store data.transactionId separately from the request and quote IDs. Bank collection requests can return a virtualAccount, or status=PENDING with virtualAccount=null; retrieve the transaction for later account details. Initiation is not payment success. Sandbox uses the same suffix under /api/sandbox/b2b/cross-border/requests with a sandbox bearer token.

post/api/b2b/cross-border/requests/charges/{requestId}

Request

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

Path parameters

requestIdstring required

Cross-border request ID.

Request body

quoteIdstring required

Confirmed, unused, unexpired quote for the request's exact source amount and currencies, from the same account and environment.

Response

Successful response.

successtrue required

Changes