API Reference

Query Transaction

The Transaction Query endpoint allows you to retrieve the current status and details of a payment session on Fiato. It returns information such as the transaction reference, amount, payment status, crypto network, wallet address, and timestamps — enabling you to confirm whether a transaction is pending, completed, or failed.

HEADER

Every request to the API must include your API key in the header using the x-api-key field
‎‎‎‎‎

{
  "reference": "SYBIU9Z0YIIG"
}
KEYValueDescription
referencee.g SYBIU9Z0YIIGThis is fiato's reference generated at the time of transaction initialization.

{
  "status": "success",
  "event": "settlement_complete",
  "f_reference": "SYBIU9Z0YIIG",
  "payout_amount": 5000,
  "payer_name": "Comfort Samuel",
  "payer_email": [email protected],
  "payment_status": "complete",
  "open_time": 1762291775,
  "coin": "usdt",
  "wallet": "0xEAf0F17E833b950958332b0689C968231286561f",
  "message": "fiat settled successfully"
  
}