Skip to main content
POST
/
api
/
v2
/
payouts
Create Payouts
curl --request POST \
  --url https://sandbox.killb.app/api/v2/payouts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "preFundAccountId": "<string>",
  "amount": 123,
  "beneficiary": {
    "type": "ACH_CO",
    "account": {
      "firstName": "<string>",
      "lastName": "<string>",
      "companyName": "<string>",
      "email": "<string>",
      "phone": "<string>",
      "document": {
        "type": "NIT",
        "number": "123456",
        "issuedCountryCode": "CO"
      },
      "accountNumber": "<string>",
      "bankCode": "<string>",
      "type": "savings",
      "countryCode": "<string>",
      "middleName": "<string>"
    }
  },
  "externalId": "d00e4f43-2022-42f3-ba1c-dcf4c1dcd934"
}
'
{
  "id": "<string>",
  "amount": 123,
  "currency": "<string>",
  "beneficiary": {
    "type": "ACH_CO",
    "account": {
      "firstName": "<string>",
      "lastName": "<string>",
      "companyName": "<string>",
      "email": "<string>",
      "phone": "<string>",
      "document": {
        "type": "NIT",
        "number": "123456",
        "issuedCountryCode": "CO"
      },
      "accountNumber": "<string>",
      "bankCode": "<string>",
      "type": "savings",
      "countryCode": "<string>",
      "middleName": "<string>"
    }
  },
  "status": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "externalId": "<string>"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key
string

Unique key to ensure idempotent request handling. If a request with the same key was already processed, the cached response is returned.

Body

application/json
preFundAccountId
string
required
amount
number
required
beneficiary
object
required
externalId
string

identifier used to identify your existing payouts

Example:

"d00e4f43-2022-42f3-ba1c-dcf4c1dcd934"

Response

id
string
required
amount
number
required
currency
string
required
beneficiary
object
required
status
string
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
externalId
string