Create an instant settlement request

curl -X POST "https://test-api.kashier.io/v3/payment/instant-settlements/instant-requests" \  -H "Content-Type: application/json" \  -d '{    "transactionIds": [      "TX-1001",      "TX-1002"    ]  }'

{  "message": "success",  "data": {    "id": "d2719f9a-3a36-4f10-9c7b-1f2e3d4c5b6a",    "requestId": "ISR-1042",    "merchantId": "MID-957-917",    "merchantName": "Acme Stores LLC",    "storeName": "Acme Downtown",    "status": "PENDING",    "declineReason": null,    "totalAmount": 15000,    "totalSettlementAmount": 15000,    "totalRateFees": 225,    "flatFees": 0,    "vat": 31.5,    "totalFees": 256.5,    "netTransferAmount": 14743.5,    "transactionsCount": 2,    "requestedBy": "[email protected]",    "statusHistory": [      {        "status": "PENDING",        "at": "2026-06-13T08:00:00.000Z",        "by": "[email protected]"      }    ],    "createdAt": "2026-06-13T08:00:00.000Z",    "updatedAt": "2026-06-13T08:00:00.000Z"  }}

Creates an instant settlement request over the selected transactions. The request is created in PENDING status and is then reviewed by Kashier: approval moves it to PROCESSING and deducts the early-payout amount from your balance, and the payout itself moves it to TRANSFERRED. A request that will not be processed becomes DECLINED with a declineReason.

Every transaction is re-validated against the eligibility rules at creation time, and the request is rejected whole if any of them is no longer eligible — no partial request is created. Your per-request and daily caps are enforced here as well.

Requires the instant_settlement_request feature flag and the instant_settlements.all.create_instant_settlement permission.

Response Body