Verify General Payment Link

Fetches payment link details and available customer currencies.

Use this endpoint to:

Render your checkout page
Display available currencies
Show item breakdown
Display fee configuration

To retrieve the details of a general payment link and render your checkout page, make a GET request to the verify endpoint using the payment link code.

Note: This endpoint does not require authentication.

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

If the API call is successful, Kyshi returns the link status, available currencies, item breakdown, and fee configuration.

{
  "status": true,
  "code": 200,
  "message": "Success",
  "data": {
    "status": "PENDING",
    "reference": "KYSHI-1770114609126",
    "paymentLink": {
      "code": "2czAof9LgS8KUnA",
      "url": "https://merchant.kyshi.co/payment/2czAof9LgS8KUnA",
      "expiresAt": null
    },
    "amount": {
      "value": 600,
      "currency": "USD"
    },
    "availableCurrencies": ["KES", "NGN", "GHS"],
    "feeBearer": "CUSTOMER",
    "taxChargeable": "EXCLUSIVE",
    "metadata": [
      {
        "name": "Book",
        "amount": 600,
        "quantity": 1,
        "localAmount": 0,
        "integrationId": ""
      }
    ]
  }
}