POST
/
v1
/
businesses
/
{businessId}
/
payouts

Authorizations

Authorization
string
headerrequired

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
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

processor
enum<string>
required

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
paid_out_amount
integer
required

The amount of the payout, in cents.

completed_at
string
required

Timestamp of when the payout was completed

payments
object[]
required

List of payments to associate with the payout

refunds_amount
integer

The amount of refunds associated with the payout, in cents.

overwrite_payment_fees
boolean | null

Whether to overwrite payment fees or not upon creation

Response

200 - application/json
id
string

Unique ID for the Payout. Idempotency key.

external_id
string | null

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

business_id
string

ID of the Business that generated the payout.

paid_out_amount
integer

The amount of the payout, in cents

fee
integer

The platform fee 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
imported_at
string

Timestamp of when the payout was imported

completed_at
string

Timestamp of when the payout was completed

match
object

The transaction match associated with the payout

payments
object[]

A list of invoice payments associated with the payout

transaction_tags
object[]

A list of tags associated with the payout