Skip to main content
POST
/
payment-links
/
verify
Verify a payment link
curl --request POST \
  --url https://prod-api.pcxpay.com/v1/payment-links/verify \
  --header 'Content-Type: application/json' \
  --data '
{
  "link_id": "lnk_a1b2c3d4"
}
'
{
  "valid": true,
  "link": {
    "link_id": "lnk_a1b2c3d4",
    "transaction_id": "txn_xyz789",
    "org_id": "org_abc123",
    "payment_link": "https://pay.pcxpay.com/lnk_a1b2c3d4",
    "expires_at": "2026-04-16T10:00:00",
    "expires_at_timestamp": 1744790400,
    "status": "active",
    "email": "customer@example.com",
    "payment_amount": 5000,
    "scheduled_at": "2026-04-15T10:00:00",
    "created_at": "2026-04-13T08:00:00",
    "currency": "NGN"
  }
}

Body

application/json

The payment link ID to verify.

Example:

"lnk_a1b2c3d4"

Response

Link verification result.

valid
boolean
Example:

true