Key Features
- Create Payouts: Initiate payouts to users or vendors with specified amounts and currencies.
- Retrieve Payouts: Fetch details of individual payouts or a list of all payouts.
- Update Payouts: Modify payout details such as status or amount.
- Delete Payouts: Remove payouts that are no longer needed.
- Search Payouts: Search for payouts based on criteria like status and date range.
Common Endpoints
POST /v1/payouts: Create a new payout.GET /v1/payout/{payoutId}: Retrieve details of a specific payout.GET /v1/payouts: Retrieve a list of all payouts.GET /v1/payouts/search: Search for payouts based on various criteria.PUT /v1/payout/{payoutId}: Update details of a specific payout.DELETE /v1/payout/{payoutId}: Delete a specific payout.
Authentication
All endpoints require authentication using an API key. Include the API key in the request headers as follows:Error Handling
The Payout API uses standard HTTP status codes to indicate the success or failure of an API request. Common status codes include:200 OK: The request was successful.400 Bad Request: The request was invalid or malformed.401 Unauthorized: Authentication failed or was not provided.404 Not Found: The requested resource was not found.500 Internal Server Error: An error occurred on the server.
Rate Limiting
To ensure fair usage, the Payout API enforces rate limits on the number of requests that can be made within a specific time frame. If you exceed the rate limit, you will receive a429 Too Many Requests response.