curl --request POST \
  --url https://api.dots.dev/api/v2/payout-requests \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "amount": 123,
  "memo": "<string>",
  "metadata": "<string>",
  "payee": {
    "country_code": "<string>",
    "phone_number": "<string>"
  },
  "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "amount": 123,
  "created": "2023-11-07T05:31:56Z",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "memo": "<string>",
  "metadata": "<string>",
  "payee": {
    "country_code": "<string>",
    "phone_number": "<string>"
  },
  "payout-link": {
    "amount": 123,
    "claimed_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created": "2023-11-07T05:31:56Z",
    "delivery": {
      "country_code": "<string>",
      "email": "jsmith@example.com",
      "method": "link",
      "phone_number": "<string>"
    },
    "flow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "link": "<string>",
    "metadata": "<string>",
    "payee": {
      "country_code": "<string>",
      "email": "jsmith@example.com",
      "first_name": "<string>",
      "last_name": "<string>",
      "phone_number": "<string>"
    },
    "status": "sent",
    "tax_exempt": true
  },
  "status": "created",
  "user": {
    "compliance": {
      "1099_collected": true,
      "address_collected": true,
      "date_of_birth_collected": true,
      "flagged": true,
      "id_verified": true,
      "must_collect_1099": true,
      "tax_id_collected": true,
      "w8_ben_collected": true
    },
    "email": "jsmith@example.com",
    "first_name": "<string>",
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "last_name": "<string>",
    "metadata": "<string>",
    "phone_number": {
      "country_code": "<string>",
      "phone_number": "<string>"
    },
    "wallet": {
      "amount": 123,
      "credit_balance": 123,
      "withdrawable_amount": 123
    }
  }
}

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

The amount in cents to pay the user.

memo
string

Add a memo to payout request

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.

user_id
string

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

Response

201 - application/json
amount
number

Amount in cents of the payout-request.

created
string

Date that the payout-request was created.

id
string

ID of the payout-request.

memo
string
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
payout-link
object
status
enum<string>

Status of the payout-request.

Available options:
created,
approved,
rejected
user
object