Order | Fonbnk Docs

Fonbnk Docs

Returns a single pay widget order by its ID or orderParams query parameter.

get

/api/pay-widget-merchant/order

Authorizations

Query parameters

orderIdstring

id of the order which you could receive via a webhook or iframe events

orderParamsstring

Value which you provided in the orderParams parameter of the pay widget URL

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://sandbox-api.fonbnk.com/api/pay-widget-merchant/order' \
  --header 'x-client-id: YOUR_API_KEY'

200

{
  "_id": "651e764399a4b360c7eb0178",
  "walletType": "SOLANA",
  "asset": "USDC",
  "walletAddress": "53L9ahwHcNnD4F11TqNHQgVUa75WgaCL2WGeiKiK2gCc",
  "feePercent": 2.5,
  "fonbnkFeePercent": 1.5,
  "partnerFeePercent": 1,
  "gasUsdAmount": 0,
  "merchantId": "645a20cbaf1d31dbd52c0fda",
  "createdAt": "2023-10-05T08:39:31.691Z",
  "feeAmount": 0.05,
  "localCurrencyFeeAmount": 50,
  "fonbnkFeeAmount": 0.03,
  "localCurrencyFonbnkFeeAmount": 30,
  "partnerFeeAmount": 0.02,
  "localCurrencyPartnerFeeAmount": 20,
  "networkFeeAmount": 0,
  "localCurrencyNetworkFeeAmount": 0,
  "resumeUrl": "https://pay.fonbnk.com/swap-status?orderId=651e764399a4b360c7eb0178",
  "buySwap": {
    "_id": "651e764399a4b360c7eb016d",
    "buyerUserPhone": "380962669394",
    "sellerUserPhone": "380960000000",
    "amount": 210,
    "airtimeAmount": 2100,
    "status": "seller_confirmed",
    "provider": "bank_transfer",
    "expiresAt": "2023-10-05T09:39:31.492Z",
    "createdAt": "2023-10-05T08:39:31.500Z",
    "buyerConfirmedAt": "2023-10-05T08:39:37.027Z",
    "countryIsoCode": "NG"
  },
  "withdrawal": {
    "_id": "651e7653db37ee6b74883fe1",
    "status": "complete",
    "withdrawAmount": 2,
    "withdrawCryptoAmount": 2,
    "transactionHash": "F19TfyGxBgebZt4q8h5bgf9Luabpypm3zSSzWR5ZUp8CKGNvL2r58zqGvWXvKftppiWKszV11jNQtsMUoFppmyb"
  }
}

Successful response

Get order