Pay-outs

Pay-outs allow you to send stablecoin payments to your customers or vendors.

Overview

A pay-out is initiated when you want to send funds to an external wallet address. Celar handles the blockchain transaction and provides real-time status updates.

1. Create a Pay-out

Request

curl --request POST \
  --url https://api.sandbox.celar.io/api/v1/payments/pay-out \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <<your_api_key>>' \
  --header 'Idempotency-Key: <<random_uuid>>' \
  --data '{
    "celar_walletId": "<<celar_walletId>>",
    "destination_address": "0x...",
    "token": "USDC",
    "amount": 50,
    "chain": "base"
  }'

Response

{
  "payment_id": "pay_xyz789",
  "tx_hash": "0x...",
  "amount": 50,
  "token": "USDC",
  "status": "payout_sent"
}

2. Batch Pay-outs

Send multiple pay-outs in a single API call for efficiency:

curl --request POST \
  --url https://api.sandbox.celar.io/api/v1/payments/pay-out/batch \
  --header 'Authorization: Bearer <<your_api_key>>' \
  --data '{
    "payouts": [
      { "destination_address": "0x...", "amount": 100 },
      { "destination_address": "0x...", "amount": 50 }
    ]
  }'