Search Payouts by Merchant Reference

Search for payouts using a merchant reference. Returns matching payouts across the specified merchant IDs.

AuthorizationBearer

OAuth 2.0 access token

merchantIdsstringRequired

Comma-separated list of merchant IDs (UUIDs) to search within

merchantReferencestringRequired

The merchant reference to search for

Matching payouts returned successfully

payoutslist of objects

totalinteger

Total number of payouts matching the search

401

Unauthorized Error

422

Unprocessable Entity Error

1	curl -G https://api.crisscross.money/v1/payouts/search \
2	-H "Authorization: Bearer <token>" \
3	-d merchantIds=merchantIds \
4	-d merchantReference=merchantReference

1	{
2	"payouts": [
3	{
4	"id": "d4f7a9b8-3c2e-4f1a-9b7d-5e6f8a0c1d2e",
5	"currency": "USD",
6	"amount": 1500.75,
7	"status": "completed",
8	"createdAt": "2024-01-15T09:30:00Z",
9	"recipientType": "bank_account",
10	"recipient": {
11	"accountNumber": "****5678",
12	"bankName": "First National Bank",
13	"accountHolder": "John Doe"
14	},
15	"completedAt": "2024-01-16T14:45:00Z",
16	"reference": "INV-20240115-XYZ123",
17	"description": "Payout for invoice INV-20240115-XYZ123"
18	}
19	],
20	"total": 1
21	}