Transaction Initiation

Payout and banking transaction APIs

Initiate Payout Transaction

post

https://sandbox.kwikpaisa.comhttps://api.kwikpaisa.com

/api/v3/banking/payment/create

Initiates a payout transaction using supported transfer modes such as IMPS, NEFT, RTGS, and UPI.

Header parameters

X-API-KEYstringRequiredExample: pk_test_mQZnmh2BeSDTjEQgzwiSPOhrWyUsPqS6

X-SIGNATUREstringRequiredExample: 623a603fa35bb5ab736a1272dcd797908ab9af4b0247a55bcfc8676cd821a39b

X-TIMESTAMPstringRequiredExample: 1778659835

Body

application/json

kwikx_wallet_idstringRequiredExample: 9896989698

debit_account_typestringRequiredExample: kwikx_wallet

transfer_typestringRequiredExample: direct

beneficiary_idany · nullableOptional

mobilestringRequiredExample: 9896989698

emailstringRequiredExample: [e-mail]

addressany · nullableOptional

country_dialing_codestringRequiredExample: 91

transfer_modestringRequiredExample: imps

transfer_amountstringRequiredExample: 9999999999

payout_order_idstringRequiredExample: 9999999999

Responses

200

Payout initiated successfully

application/json

401

Authentication failed

application/json

403

Access denied or security validation failed

application/json

404

Wallet not found

application/json

422

Validation or business rule failure

application/json

post/api/v3/banking/payment/create

HTTPcURLJavaScriptPython

POST /api/v3/banking/payment/create HTTP/1.1
Host: sandbox.kwikpaisa.com
X-API-KEY: text
X-SIGNATURE: text
X-TIMESTAMP: text
Content-Type: application/json
Accept: */*
Content-Length: 463

{
  "kwikx_wallet_id": "9896989698",
  "debit_account_type": "kwikx_wallet",
  "transfer_type": "direct",
  "beneficiary_id": null,
  "mobile": "9896989698",
  "email": "[e-mail]",
  "address": null,
  "country_dialing_code": "91",
  "transfer_mode": "imps",
  "transfer_amount": "9999999999",
  "payout_order_id": "9999999999",
  "account_transfer": {
    "account_owner_name": "beneficiary name",
    "account_number": "6760654654",
    "ifsc_code": "icici000143",
    "is_validate": "false",
    "payment_for": "salary payment"
  }
}

{
  "status": true,
  "code": 200,
  "message": "Payout initiated successfully.",
  "data": {
    "payout_id": "payout_2c17a19bc5be6d05",
    "payout_order_id": 1778761733,
    "wallet_id": "2026-04-30 13:01:32",
    "debited_amount": 99,
    "available_balance": 98627.88
  }
}