POST
/
v2
/
payouts
/
send-payout
Authorization
Body
curl --request POST \
  --url https://api.senddotssandbox.com/api/v2/payouts/send-payout \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 0
}'
{
  "amount": "number",
  "claimed_user_id": "string",
  "created": "string",
  "delivery": {
    "country_code": "string",
    "email": "string",
    "method": "link",
    "phone_number": "string"
  },
  "flow_id": "string",
  "id": "string",
  "link": "string",
  "metadata": [
    "string",
    "object",
    "null"
  ],
  "payee": {
    "country_code": "string",
    "email": "string",
    "first_name": "string",
    "last_name": "string",
    "phone_number": "string"
  },
  "status": "sent",
  "tax_exempt": "boolean"
}

Authorizations

Authorizationheaderrequired
string

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

Body

application/json
additional_steps
enum<string>[]

Array of steps in the flow.

Available options:
compliance,
id-verification,
background-check,
manage-payments,
manage-payouts,
payout,
redirect
amountrequired
integer

The amount in cents to pay the user.

delivery
object
force_collect_compliance_information
Default: false
boolean

Collect 1099 or w8-ben information.

idempotency_key
string | null

Unique UUID key that prevents duplicate requests from being processed. If a payout link with the idempotency key exists, a new link will not be created and the existing link will be returned instead.

memo
string

Add a memo to the top of the Payout Link

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.

payee
object

The payee's phone number. user_id or payee is required.

payout_fee_party
enum<string> | null

Overrides the setting for which party will pay fees on this payout. This takes precedence over the default for your application.

Available options:
user,
platform
tax_exempt
boolean

Payouts marked as tax_exempt will not be counted towards the 1099 threshold.

user_id
string

The user's id. user_id or payee is required.

Response

201 - application/json
amount
number

The amount to pay in cents.

claimed_user_id
string

ID of the user that has claimed the payout-link.

created
string

Date the payout-link was created.

delivery
object
flow_id
string

ID of the payout flow UI that is sent to the user.

id
string

ID of the payout-link.

link
string

URL to access the payout-link.

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.

payee
object

Information about the payee. It is used to pre-fill information.

status
enum<string>

Status of the payout-link.

Available options:
sent,
claimed,
delivery_pending,
delivery_failed,
delivered,
canceled
tax_exempt
boolean

Transfers marked as tax_exempt will not be counted towards the 1099 threshold.

Payouts OverviewCreate a Payout