Payout flow

Track NGN-to-USDC conversion and settlement from the ledger. Payouts are batched daily with full audit trail.

Overview

Payouts in Propeller are automatic — you don't trigger them. Once payments clear, Propeller:

Accumulates cleared NGN for the business.
Executes FX (NGN → USDC) via Globalstack at the daily batch (17:00 WAT).
Delivers USDC to the business's settlement address.

Viewing payouts

curl https://api.withpropeller.com/v1/payouts?business_id=biz_01J... \\
  -H "Authorization: Bearer $PROPELLER_KEY"

Response:

{
  "data": [
    {
      "id": "pay_01J...",
      "business_id": "biz_01J...",
      "amount_ngn": 500000,
      "amount_usdc": 315.72,
      "rate": 1583.45,
      "status": "completed",
      "tx_hash": "0x...",
      "created_at": "2026-05-14T17:30:00Z"
    }
  ]
}

Payout lifecycle

Status	Description
`pending`	NGN received, awaiting daily batch.
`processing`	FX execution in progress.
`settled`	USDC delivered, tx hash available.
`failed`	Settlement failed — Propeller ops investigates.

Reconciliation

Each payout has:

Source payment IDs (the NGN payments it aggregated).
FX rate used.
USDC transaction hash (for on-chain verification).

Use GET /v1/payouts/{id} for the full breakdown.

Last updated · 14 May 2026