# Create Settlement Create a settlement request to withdraw funds to your bank account. ## Request ### Headers ### Body Parameters ## Response ### Success (201 Created) ```json { "success": true, "data": { "settlementId": "stl_xxxxx", "merchantId": "mer_xxxxx", "amount": 100000, "settlementFee": 500, "netAmount": 99500, "currency": "USD", "type": "standard", "priority": "normal", "status": "PENDING", "description": "Monthly settlement", "bankAccountId": "ba_xxxxx", "scheduledDate": null, "createdAt": "2024-01-15T10:30:00.000Z" } } ``` ### Response Fields ### Error Responses ## Examples ```bash curl -X POST https://api.zenpayz.com/merchant/api/v1/settlements/create \ -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" \ -d '{ "amount": 100000, "bankAccountId": "ba_xxxxx", "description": "Monthly settlement", "priority": "normal", "type": "standard" }' ``` ```javascript const settlement = await zenpays.settlements.create({ amount: 100000, bankAccountId: 'ba_xxxxx', description: 'Monthly settlement', priority: 'normal', type: 'standard', }); ``` ## Settlement Status | Status | Description | |--------|-------------| | `PENDING` | Settlement created, awaiting processing | | `PROCESSING` | Being processed | | `COMPLETED` | Funds transferred to bank | | `FAILED` | Settlement failed | | `CANCELLED` | Settlement was cancelled |