POST
/
v1
/
businesses
/
{businessId}
/
payouts

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Content-Type
string

Content-Type must be set to application/json

Path Parameters

businessId
string
required

The UUID of the business to create a payout for

Body

application/json
completed_at
string
required

Timestamp of when the payout was completed

external_id
string
required

Unique ID of the payout in your system for linking purposes.

fee
integer
required

The platform fee associated with the payout. Should be expressed as a positive value.

paid_out_amount
integer
required

The amount of the payout, in cents. This amount can be negative if refunds and fees exceed payments.

payments
object[]
required

List of payments to associate with the payout

processor
enum<string>
required

Processor used to make the payment.

Available options:
STRIPE,
PAYPAL
additional_refunds_amount
integer
default:
0

The amount of additional refunds associated with the payout, in cents. This should only be used when refunds cannot be individually itemized in the refunds array. Should be expressed as a positive value.

refunds
object[]

List of refunds to associate with the payout

Response

200 - application/json
business_id
string

ID of the Business that generated the payout.

completed_at
string

Timestamp of when the payout was completed

external_id
string | null

Unique ID of the payout in your system for linking purposes.

fee
integer

The platform fee associated with the payout

id
string

Unique ID for the Payout. Idempotency key.

imported_at
string

Timestamp of when the payout was imported

match
object

The transaction match associated with the payout

paid_out_amount
integer

The amount of the payout, in cents

payments
object[]

A list of invoice payments associated with the payout

processor
enum<string>

Processor used to make the payment, if any. Any processor name can be provided and will be tracked. Supported processors (STRIPE, SHOPIFY) will have additional asset balance tracking.

Available options:
STRIPE,
PAYPAL
transaction_tags
object[]

A list of tags associated with the payout