---
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`

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.net/boomfi/apis/boomfi-merchants-api.md) · [All operations](https://skmtc.net/boomfi/apis/boomfi-merchants-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/boomfi/boomfi-merchants-api/revisions/ace3c3df05fe/schema)