Manage wallets, escrow accounts, invoices, and payouts via the Payments API.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/wallets/:id | Get wallet balance and details |
| GET | /v1/wallets/:id/transactions | List wallet transactions |
| POST | /v1/escrow | Create escrow account for a booking |
| GET | /v1/escrow/:id | Get escrow status and details |
| POST | /v1/escrow/:id/fund | Fund escrow (client deposits payment) |
| POST | /v1/escrow/:id/release | Release escrow funds |
| POST | /v1/escrow/:id/dispute | Raise dispute on escrow |
| POST | /v1/payouts | Create payout request |
| GET | /v1/payouts/:id | Get payout status |
| POST | /v1/payouts/:id/approve | Approve payout (Finance/Admin) |
Idempotency Required
All payment mutation endpoints require an Idempotency-Key header. This prevents double-charges or duplicate payouts in case of network retries.
POST /v1/escrow
Idempotency-Key: idk_unique_key_123
{
"booking_id": "bk_abc123",
"amount": 50000,
"currency": "INR",
"milestones": [
{ "label": "Shoot Day 1", "amount": 25000, "due_date": "2026-04-20" },
{ "label": "Shoot Day 2", "amount": 25000, "due_date": "2026-04-21" }
],
"commission_split": {
"talent": 0.70,
"agency": 0.20,
"platform": 0.05,
"tax": 0.05
}
}