Retrieving an Authorization

Use this to confirm the current status of an authorization (e.g. after the customer has gone through the approval flow).

Endpoint (GET)

https://api.korapay.com/merchant//api/v1/direct-debit/authorizations/{reference}

Path Parameters

PARAMETER	TYPE	REQUIRED	DESCRIPTION
reference	string	Yes	The authorization's reference returned at creation.

Sample Request

curl -X GET https://api.korapay.com/merchant/api/v1/direct-debit/authorizations/KPY-AUTH-7d2f9c0e \
  -H "Authorization: Bearer sk_live_xxx"

Sample Success Response

{
  "status": true,
  "message": "success",
  "data": {
    "reference": "KPY-AUTH-7d2f9c0e",
    "status": "active",
    "amount": 500000,
    "currency": "NGN",
    "type": "variable",
    "account_name": "JANE ADAEZE DOE",
    "account_number": "0123456789",
    "bank_code": "044",
    "bank_name": "Access Bank",
    "status_update_reason": null,
    "start_date": "2026-04-01",
    "end_date": "2026-12-31"
  }
}

Possible status Values

Status	Meaning
`pending`	Customer has not yet completed the approval flow.
`active`	Authorization is approved by the bank and immediately ready to debit.
`suspended`	Temporarily disabled (by the merchant or admin). Cannot be debited until re‑activated.
`deactivated`	Permanently disabled.
`expired`	The end_date has passed. No further debits allowed.