KKatch Developers

Create wallet top-up payment link

POST
/tasks/wallet-topup

Creates a KNET payment link to top up the wallet. The wallet is credited once the link is paid. Link expires in 24 hours.

Authorization

apiKeyAuth
headerAuthorization<token>

Required on every request. Send apikey <your-api-key>, together with the x-seller-id header.

Header Parameters

x-seller-id*string

Your seller id.

Request Body

application/json
  1. body
amount*number

Top-up amount in KWD (minimum 5, max 3 decimals)

Range5 <= value
description?string

Response Body

Payment link created successfully

application/json
  1. response
paymentId?string
paymentUrl?string
amount?number
currency?string
paymentMethod?string
paymentStatus?string
expiresAt?string
Formatdate-time
curl -X POST "https://example.com/tasks/wallet-topup" \  -H "x-seller-id: YOUR_SELLER_ID" \  -H "Content-Type: application/json" \  -d '{    "amount": 50  }'
{  "paymentId": "string",  "paymentUrl": "https://pay.example.com/...",  "amount": 50,  "currency": "KWD",  "paymentMethod": "KNET",  "paymentStatus": "pending",  "expiresAt": "2019-08-24T14:15:22Z"}