Verify Payment Link

The verify payment link API allows you to confirm the status of a payment link, retrieve the checkout authorization URL, and ensure the link is still valid before redirecting a customer.

Payment Link Status

Status	Description
PENDING	Payment has not been completed
SUCCESS	Payment completed successfully
FAILED	Payment failed
COLLECTED	Payment already collected
EXPIRED	Payment link has expired

Verify Payment Link

You verify a payment link by making a GET request using the payment link code.

Note: This endpoint requires API key authentication.

-H "x-api-key: your_secret_key"

{{host}}/v1/pay/integration/verify/:code

If the payment link is valid and pending, Kyshi returns:

{
  "status": true,
  "code": 200,
  "message": "Success",
  "data": {
    "status": "PENDING",
    "reference": "KYSHI-1770114609126",
    "authorizationUrl": "https://checkout.paystack.com/5l12qbpx42b1vye",
    "paymentLink": {
      "expiresAt": "2026-02-04T01:35:04.000Z"
    },
    "amount": {
      "value": 74205,
      "currency": "KES"
    }
  }
}

Notes

authorizationUrl is only returned when the payment status is PENDING
Merchants should redirect customers to authorizationUrl to complete payment
If the status is SUCCESS, FAILED, or EXPIRED, no redirect should be attempted