Skip to main content
POST
/
v1
/
payments
/
verify
Verify payment
curl --request POST \
  --url https://api.platnova.com/v1/payments/verify \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "ref": "UTR_7HeRoy4CRl6hcOOqAzwAeo0WLLMMbt"
}
'
{
  "status": true,
  "data": {
    "id": "<string>",
    "ref": "<string>",
    "currency": "<string>",
    "amount": 123,
    "fee": 123,
    "type": "<string>",
    "status": "<string>",
    "entry": "<string>",
    "message": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  },
  "error": [
    "<unknown>"
  ],
  "message": "<string>"
}

Overview

Verify a payment by its reference. This endpoint receives a payment reference and returns the transaction details including status, amount, and recipient information.

Authorizations

X-API-KEY
string
header
required

API key for authentication.

Body

application/json
ref
string
required

Transaction/payment reference to verify

Response

Payment details retrieved successfully

status
boolean
data
object
error
any[]
message
string