Sent when a new batch is created under your payor account.
batch-created tells you that a new batch exists under your payor account.
When it fires
- You create a batch with Create Batch or from the dashboard.
- Payment Labs creates a batch for you, for example when you approve payment requests into a new batch.
What to do
- Store the batch
idnext to yourreferenceId. - Payments added to the batch fire their own payment-created events.
Payload
data is the batch as Get Batch describes it, read when the webhook is sent. Fields with no value are omitted. Amounts use the Money object. Totals are arrays with one entry per currency in the batch, and an empty array when there is nothing to count.
| Field | Type | Description |
|---|---|---|
id | string | Batch ID. |
payorId | string | Your payor ID. |
referenceId | string | Your own reference for the batch. |
name | string | Batch name, shown to you and to payees, for example Weekly payroll. |
taxJurisdiction | string | Tax rules applied to the batch's payments: us, de, fi, gb, my, pl, sa, se, or none. |
defaultPaymentCategory | string | Category given to new payments that do not set one. One of online-esport-prize, in-person-esport-prize, in-person-esport-prize-out-of-jurisdiction, athlete-prize, online-misc-prize, online-contest-prize, in-person-misc-prize, in-person-contest-prize, remote-contractors, in-person-contractors, reimbursement, royalties. |
archived | boolean | true if the batch is archived. |
allowedPaymentMethods | string[] | Payout methods payees may use for this batch's payments, for example bank-transfer-1. Absent when every method enabled for your account is allowed. |
deniedCountries | string[] | Two-letter ISO country codes of payees this batch must not pay. Payments to them become RESTRICTED. |
onboarded | number | Share of the batch's payments whose payee is payable, from 0 to 1. |
numberOfPayments | number | Payments in the batch. |
numberOfPaidPayments | number | Payments that have been paid. |
numberOfUnpaidPayments | number | Payments not yet paid. |
numberOfPayableNowPayments | number | Payments you can submit now. |
numberOfCancelledPayments | number | Payments that were cancelled. |
totalAmount | Money[] | Total of all payments, excluding cancelled ones. |
totalPaid | Money[] | Total already paid. |
totalUnpaid | Money[] | Total not yet paid. |
totalPayableNow | Money[] | Total you can submit now. |
totalCancelled | Money[] | Total of cancelled payments. |
paymentsSummary | object | The same counts and totals grouped by state. Has total, paid, unpaid, payableNow and cancelled, each with amount (Money[]), count (number) and byCurrency (array of {currency, totalAmount, count}), plus onboardedPercentage (number, 0 to 1). |
auditInfo | object | createdAt, updatedAt (ISO 8601 UTC), createdBy and updatedBy. |
Counts and totals are recalculated in the background as payments change. They do not fire this event themselves, so the figures in a delivery are only as current as the moment it was sent. Use Get Batch for current figures.
Example
The full request body Payment Labs sends:
{
"payorId": "C-01JBX2Q8F4H6K8M0N2P4R6T8VW",
"event": "batch-created",
"timestamp": "2026-03-14T13:55:03.412Z",
"data": {
"archived": false,
"payorId": "C-01JBX2Q8F4H6K8M0N2P4R6T8VW",
"id": "B-01JC8Z1B2C3D4E5F6G7H8J9K0M",
"name": "March tournament prizes",
"referenceId": "payrun-2026-03",
"taxJurisdiction": "us",
"defaultPaymentCategory": "online-esport-prize",
"auditInfo": {
"createdAt": "2026-03-14T13:55:02.000Z",
"updatedAt": "2026-03-14T13:55:02.000Z",
"createdBy": "[email protected]",
"updatedBy": "[email protected]"
},
"allowedPaymentMethods": [
"bank-transfer-1",
"paypal"
],
"deniedCountries": [
"KP"
],
"numberOfPayments": 0,
"numberOfPaidPayments": 0,
"numberOfUnpaidPayments": 0,
"numberOfPayableNowPayments": 0,
"numberOfCancelledPayments": 0,
"onboarded": 0,
"totalAmount": [],
"totalPaid": [],
"totalCancelled": [],
"totalUnpaid": [],
"totalPayableNow": []
}
}