FinvyPayAPI Docs

Status API

Check the status of a payment or transaction by transaction ID or order ID.

Get Payment Status (Production)

GET/api/v1/production/status
Requires API Key

Returns the current status of a payment or transaction. Use either transactionId or orderId to look up the status.

Query Parameters

ParameterTypeRequiredDescription
transactionIdstringYes*Transaction ID (e.g. from card or APM payment response)
orderIdstringYes*Your order reference. Provide either transactionId or orderId

* Exactly one of transactionId or orderId is required.

Example Request

GET /api/v1/production/status?transactionId=FP260231SJWKL80027
GET /api/v1/production/status?orderId=ORD-12345

Success — transaction found

200
{
  "success": true,
  "data": {
    "transactionId": "FP260231SJWKL80027",
    "orderId": "ORD-12345",
    "status": "SUCCESS",
    "amount": 100,
    "currency": "USD",
    "paymentMethod": "card",
    "createdAt": "2024-03-07T12:00:00.000Z",
    "completedAt": "2024-03-07T12:00:05.000Z",
    "metadata": {}
  }
}

Not found

404
{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "No transaction found for the given transactionId or orderId."
  }
}
Possible status values: PENDING, REDIRECT (awaiting 3DS or APM completion), SUCCESS, FAILED, DECLINED, CANCELLED.

Get Payment Status (Sandbox)

GET/api/v1/sandbox/status
Requires API Key

Returns the status of a payment or transaction in sandbox. Same parameters and response shape as production.

Query Parameters

Same as production: transactionId or orderId (one required).

GET /api/v1/sandbox/status?transactionId=FP2603YFGPKSWF0060

Success — sandbox

200
{
  "success": true,
  "data": {
    "transactionId": "FP2603YFGPKSWF0060",
    "orderId": "e21be056-d0c2-4003-be28-28dc88684b35",
    "status": "SUCCESS",
    "amount": 11,
    "currency": "USD",
    "paymentMethod": "card",
    "createdAt": "2024-03-07T14:32:00.000Z",
    "completedAt": "2024-03-07T14:32:08.000Z",
    "metadata": {}
  }
}