Kutanapay Merchant API
  1. Merchant Checkout
Kutanapay Merchant API
  • Merchant API Keys
    • Create Api Key
      POST
    • Get Api Keys
      GET
    • Revoke Api Key
      DELETE
  • Merchant Wallet
    • Get All Wallets
      GET
    • Get Wallet Transactions
      GET
    • Process Refund
      POST
    • Get Settlement Batches
      GET
    • Update Wallet Status
      PATCH
    • Get Wallet By Currency
      GET
  • Merchant Customer Transactions
    • Get Merchant Transactions
      GET
    • Get Merchant Transaction
      GET
  • Merchant Checkout
    • Create Checkout
      POST
    • List Checkouts
      GET
    • Get Checkout
      GET
  • Merchant Webhooks
    • Create Webhook
      POST
    • Get Webhooks
      GET
    • Update Webhook
      PUT
    • Delete Webhook
      DELETE
  • Merchant Branding
    • Get Branding
      GET
    • Update Branding
      PUT
  • Merchant Payment Accounts
    • Add Payment Account
      POST
    • Get Payment Accounts
      GET
    • Get Payment Account
      GET
    • Update Payment Account
      PUT
    • Delete Payment Account
      DELETE
  • Merchant Withdrawals
    • Initiate Withdrawal
    • Get Withdrawal History
    • Cancel Withdrawal
    • Get Withdrawal
  • Merchant Payouts
    • Initiate Payout
    • Get Payout History
    • Cancel Payout
    • Get Payout
  1. Merchant Checkout

Get Checkout

GET
/api/v1/merchants/checkouts/{checkout_id}
Get checkout by ID (Public endpoint for customers)

Request

Authorization
Add parameter in header
x-api-key
Example:
x-api-key: ********************
Path Params

Responses

🟢200OK
application/json
Successful Response
Body

🟠422Parameter Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/v1/merchants/checkouts/5e70bd2a-1d15-4e47-a54e-aeb395ddb2a8' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success
{
    "data": {
        "id": "5e70bd2a-1d15-4e47-a54e-aeb395ddb2a8",
        "merchant_id": "7bb54443-6fc9-4a1d-ab46-d787ec90c87f",
        "customer_email": "reject.fixed@test.com",
        "customer_name": "Reject Fix Test",
        "customer_phone": null,
        "amount": 30.0,
        "currency_code": "GHS",
        "description": "Testing rejection fix",
        "status": "failed",
        "payment_method": "bank_transfer",
        "payment_reference": "PAY-AWVE0CRD8KZ3",
        "expires_at": "2025-11-17T16:20:14.066282",
        "paid_at": "2025-11-17T16:10:30.125422",
        "completed_at": null,
        "checkout_url": "http://localhost:3000/public/checkouts/PAY-AWVE0CRD8KZ3",
        "redirect_url": null,
        "meta_data": null,
        "approval_status": "rejected",
        "approved_by_admin_id": null,
        "approved_at": null,
        "rejection_reason": "Invalid payment proof - image blurry and unverifiable",
        "admin_notes": "Customer provided screenshot instead of bank receipt",
        "created_at": "2025-11-17T17:10:14.062559",
        "updated_at": "2025-11-17T16:10:34.165921"
    },
    "message": "Checkout retrieved successfully",
    "status": "success"
}
Modified at 2025-11-19 15:13:12
Previous
List Checkouts
Next
Merchant Webhooks
Built with