Create Payout (Bulk)

POST

https://api.crisscross.money/v1/payouts/bulk

POST

/v1/payouts/bulk

1 import requests
2 
3 url = "https://api.crisscross.money/v1/payouts/bulk"
4 
5 payload = { "body": { "payouts": [
6             {
7                 "merchantId": "merchant_987654321",
8                 "merchantReference": "order_123456789",
9                 "destinationValue": {
10                     "minorAmount": 250000,
11                     "currency": "NGN"
12                 },
13                 "paymentMethodId": "banktransfer",
14                 "paymentLocation": "NGA",
15                 "recipient": {
16                     "type": "bank_account",
17                     "accountNumber": "0123456789",
18                     "bankCode": "058",
19                     "accountHolderName": "Chinedu Okafor",
20                     "country": "NGA"
21                 }
22             }
23         ] } }
24 headers = {
25     "Authorization": "Bearer <token>",
26     "Content-Type": "application/json"
27 }
28 
29 response = requests.post(url, json=payload, headers=headers)
30 
31 print(response.json())

Try it

202Accepted

1 {
2   "payouts": [
3     {
4       "transactionId": "txn_20240612_001",
5       "status": "PENDING",
6       "message": "Payout scheduled successfully",
7       "merchantReference": "order_123456789",
8       "payoutState": {
9         "type": "pending"
10       },
11       "processorReference": "proc_789654123",
12       "estimatedCompletion": "2024-06-15T09:30:00Z",
13       "createdAt": "2024-06-12T09:30:00Z",
14       "completedAt": "",
15       "failureReason": ""
16     }
17   ],
18   "total": 1,
19   "successful": 1,
20   "failed": 0
21 }

Schedule multiple payouts in a single request, ideal for handling larger batches of disbursements.

Authentication

AuthorizationBearer

OAuth 2.0 access token

Request

This endpoint expects an object.

payoutslist of objectsRequired

Array of payout requests (max 100 per batch)

Response

Bulk payouts accepted for processing

messagestring

Status message confirming the batch was accepted

batchIdstring

Identifier for the batch

monitorUrlstring

URL to poll for batch status

Authentication

Request

Response

Errors