Get Buy Status

Check the status of a Buy transaction.

Retrieves the current status of a Buy transaction.

Endpoint

GET /v1/buy/status

Authentication

Header	Value
x-api-key	Your API key

Query parameters

Parameter	Type	Required	Description
reference	string	Yes	Your unique transaction reference

Example request

cURL

curl -X GET "https://ramp-api.ivorypay.io/api/v1/buy/status?reference=770e8400-e29b-41d4-a716-446655440002" \
  -H "x-api-key: your_api_key"

Node.js

Python

Go

Example response

{
  "statusCode": 200,
  "success": true,
  "message": "Query successful",
  "data": {
    "reference": "770e8400-e29b-41d4-a716-446655440002",
    "status": "SUCCESS",
    "fiatAmount": 25000,
    "currency": "NGN",
    "createdAt": "2026-03-26T12:00:00.000Z"
  }
}

Transaction statuses

Status	Description
INITIATED	Transaction created, awaiting fiat payment
PENDING	Payment session active
FIAT_PAYMENT_RECEIVED	Payment confirmed
SUCCESS	Transaction completed
FAILED	Transaction failed
MISMATCH	Amount received differs from expected
EXPIRED	Payment session expired