POST

Check Payment Status

http://localhost:5000/api/v1/developer/payments/check-payment-status

Checks the current status of a payment initiated via a virtual account using its unique external reference. This endpoint provides real-time updates on payment status including success, pending, or expired states. Required Fields: externalReference: The unique identifier for the payment request

// Headers

KEY	VALUE	DESCRIPTION
X-API-Key	X-API-Key	-
X-API-Secret	X-API-Secret	-

// Request Body

// JavaScriptjavascript.js

// Using fetch APIconst response = await fetch("http://localhost:5000/api/v1/developer/payments/check-payment-status", {  method: "POST",  headers: {    "X-API-Key": "X-API-Key",    "X-API-Secret": "X-API-Secret"  },  body: JSON.stringify({  "externalReference": null})});const data = await response.json();console.log(data);

JAVASCRIPTUTF-8

Ln 2, Col 12Spaces: 2

// Parameters

Parameter	Type	Required	Description
externalReference		No

// Example Payload

// JSONpayload.json

{  "externalReference": null}

// Responses

Success response

// JSONresponse.json

{  "statusCode": 200  "message": "Payment successful"  "data" {    "amount": 5000    "accountNumber": "9876543210"    "accountName": "Jane Smith"    "bank": "First Bank"    "transactionTime": "2024-03-18T14:30:45.000Z"    "paymentReference": "PAY987654321"    "narration": "Payment for services"    "status": "success"    "senderDetails" {      "accountNumber": "9876543210"      "accountName": "Jane Smith"      "bank": "First Bank"    }  }}

JSONUTF-8

Ln 1, Col 1Spaces: 2