# Create Payout :::danger[Deprecated — Do Not Use] This endpoint is **deprecated** and will be removed in a future release. It is no longer maintained and may produce unexpected behavior. **Use [Payout Intents](/docs/rest-api/endpoints/payout-intents/create-payout-intent) instead.** Payout Intents provide a more reliable, two-step flow with preview, confirmation, smart routing, and full webhook support. ::: Create a new payout to transfer funds to a beneficiary. ## Request ### Headers ### Body Parameters ### Payout Types | Type | Description | Supported Countries | |------|-------------|---------------------| | `IMPS` | IMPS transfer | India | | `NEFT` | NEFT transfer | India | | `RTGS` | RTGS transfer | India | | `UPI` | UPI transfer | India | ## Response ### Success (201 Created) ```json { "success": true, "data": { "payoutId": "pay_xxxxx", "merchantId": "mer_xxxxx", "amount": 10000, "currency": "INR", "status": "processing", "externalPayoutId": "pout_xxxxx", "processingFee": 25, "totalDebitedAmount": 10025, "estimatedCompletion": "2024-01-15T11:00:00.000Z", "createdAt": "2024-01-15T10:30:00.000Z", "metadata": {} } } ``` ### Error Responses ## Examples ```bash curl -X POST https://api.zenpays.com/merchant/api/v1/payouts \ -H "Authorization: Bearer zp_test_xxxxx" \ -H "X-Timestamp: 2024-01-15T10:30:00.000Z" \ -H "X-Signature: a1b2c3d4e5f6..." \ -H "X-Secret-Salt: your_secret_salt" \ -H "Content-Type: application/json" \ -H "X-Idempotency-Key: payout-order-123" \ -d '{ "amount": 10000, "currency": "INR", "country": "IN", "payoutType": "IMPS", "beneficiaryAccount": "1234567890", "beneficiaryIfsc": "HDFC0001234", "beneficiaryName": "John Doe" }' ``` ```javascript const payout = await fetch('https://api.zenpays.com/merchant/api/v1/payouts', { method: 'POST', headers: { 'Authorization': `Bearer ${apiKey}`, 'X-Timestamp': timestamp, 'X-Signature': signature, 'X-Secret-Salt': secretSalt, 'Content-Type': 'application/json', }, body: JSON.stringify({ amount: 10000, currency: 'INR', country: 'IN', payoutType: 'IMPS', beneficiaryAccount: '1234567890', beneficiaryIfsc: 'HDFC0001234', beneficiaryName: 'John Doe', }), }); ``` ```javascript const payout = await zenpays.payouts.create({ amount: 10000, currency: 'INR', country: 'IN', payoutType: 'IMPS', beneficiaryAccount: '1234567890', beneficiaryIfsc: 'HDFC0001234', beneficiaryName: 'John Doe', }); console.log(payout.payoutId); // pay_xxxxx ``` ## Payout Status | Status | Description | |--------|-------------| | `pending` | Payout created, awaiting processing | | `processing` | Being processed by TSP | | `succeeded` | Funds transferred successfully | | `failed` | Payout failed | | `cancelled` | Payout was cancelled | | `reversed` | Payout was reversed | ## Related Endpoints - [Get Payout](/docs/rest-api/endpoints/payouts/get-payout) - [List Payouts](/docs/rest-api/endpoints/payouts/list-payouts) - [Preview Payout](/docs/rest-api/endpoints/payouts/preview-payout)