Authorizations

Authorization
string
headerrequired

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
user_id
string
required

ID of the user who you are creating the payout for.

amount
integer
required

Amount in cents to payout the user.

platform
enum<string>
required

Platform that you are paying out the user through,

Available options:
paypal,
venmo,
ach,
bank_transfer,
cash_app,
default
account_id
string

The bank account ID you are paying to. Required for ach and intl_bank.

fund
boolean

Creates a transfer for the amount to the user before creating the payout. The funds are returned to the App Wallet if the payout does not succeed. Please ensure that you are handling transfer failure webhooks when using this option.

tax_exempt
boolean

Payouts marked as tax_exempt will not be counted towards the 1099 threshold. Can be true only if fund is true.

idempotency_key
string

UUID that will be used to idempotently handle requests. Transfers with existing idempotency keys will be rejected.

metadata

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

Response

201 - application/json

The transfer object.

id
string
created
string
user_id
string
status
enum<string>
Available options:
created,
pending,
failed,
completed,
reversed,
canceled,
flagged
type
enum<string>
Available options:
refill,
payout,
balance
amount
number
external_data
object
transactions
object[]
metadata

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.