---
title: "Create Payout to a Crypto Wallet Address"
method: POST
path: "/partners/accounts/{account_ref}/payout/address"
tags: ["Partners"]
---

# Create Payout to a Crypto Wallet Address

`POST /partners/accounts/{account_ref}/payout/address`

## Request

- Base URL: `//mapi.boomfi.xyz` (relative, and the document’s source URL is not known)
- URL: `//mapi.boomfi.xyz/partners/accounts/{account_ref}/payout/address`
- Auth: one of:
  - API key in header `X-API-KEY`
  - API key in header `X-API-Signature`
  - API key in header `X-API-Nonce`
- TypeScript: <https://skmtc.dev/boomfi/apis/boomfi-merchants-api/docs/partners/accounts/:account_ref/payout/address/post.ts> (a function with typed inputs; its response is checked against the schema)

Execute a payout to a specified crypto wallet address. Create a transaction to transfer funds from the account to an external crypto wallet address. This endpoint facilitates outbound payments in supported cryptocurrencies while maintaining transaction security and tracking.

## Path parameters

- `account_ref` string, required

## Request body

- PartnersCreatePayoutToWalletAddressRequest
  - `amount` string, required
  - `ccy` string, required
  - `chain_id` integer, required
  - `reference` string
  - `token_address` string
  - `wallet_address` string, required

## Response `200`

OK

- PartnersPaymentResponse
  - `amount` string: amount
  - `created_at` string: created_at
  - `currency` string: currency
  - `customer` ModelsCustomer
    - `created_at` string: created_at
    - `deleted_at` string: deleted_at
    - `email` string: email
    - `id` string: id
    - `metadata` integer[]: metadata
    - `name` string: name
    - `org_id` string: org_id
    - `phone` string: phone
    - `properties` integer[]: properties
    - `reference` string: reference
    - `updated_at` string: updated_at
    - `wallet_address` string: wallet_address
  - `customer_id` string: customer_id
  - `id` string: id
  - `invoice_id` string: invoice_id
  - `next_action` string: next_action
  - `org_id` string: org_id
  - `parent_id` string: parent_id
  - `payment_method` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11: The payment method: - 1 = Unknown - 2 = Merchantcontract - 3 = Proxywallet - 4 = Unblock - 5 = Card - 6 = Googlepay - 7 = Applepay - 8 = Paypal - 9 = Directdebit - 10 = Ramp - 11 = Rampcryptosettlement
  - `properties` object
  - `scheduled_time` integer: scheduled_time
  - `source` 1 | 2 | 3 | 4: The source of this billing information. Can be one of the following: - 1 = Lago - 2 = Boomfi - 3 = Stripe - 4 = Chargebee
  - `status` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: The current status of the payment_id: - 1 = Unknown - 2 = Requirespaymentmethod - 3 = Requiresconfirmation - 4 = Requiresaction - 5 = Processing - 6 = Succeeded - 7 = Canceled - 8 = Failed
  - `updated_at` string: updated_at

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/boomfi/apis/boomfi-merchants-api.md) - [All operations](https://skmtc.dev/boomfi/apis/boomfi-merchants-api/llms.txt) - [OpenAPI document](https://skmtc.dev/boomfi/apis/boomfi-merchants-api/revisions/ace3c3df05fe?raw)