Send bulk payouts to recipients

POST

https://api.jokoor.com/v1/payouts/recipients/send-bulk

Last modified:2025-12-28 04:38:46

Maintainer:Not configured

OperationId:sendBulkRecipientPayouts

Send money to multiple recipients in a single batch operation via Wave B2P.

Features:

Process up to 100 recipients per batch

Minimum amount per recipient: 100 GMD

Returns batch ID for tracking progress

Note: For API key requests, no OTP required. For session requests, use the OTP flow first.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Bulk payout batch created

Body

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.jokoor.com/v1/payouts/recipients/send-bulk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "payouts": [
        {
            "recipient_id": "rec_abc123",
            "amount": "500.00",
            "description": "Monthly payment"
        }
    ]
}'

Response Example

{
    "data": {
        "id": "batch_abc123",
        "organization_id": "org_xyz789",
        "total_amount": "15000.00",
        "total_count": 30,
        "successful_count": 28,
        "failed_count": 2,
        "pending_count": 0,
        "status": "pending",
        "payouts": [
            {
                "id": "rp_def456",
                "recipient_id": "rec_abc123",
                "amount": "500.00",
                "status": "pending",
                "error_message": "Insufficient balance"
            }
        ],
        "created_at": "2019-08-24T14:15:22.123Z",
        "completed_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2025-12-28 04:38:46

Reverse or cancel recipient payout

Get bulk payout batch status