Payouts

Withdraw settled funds to a bank account or supported wallet. In Live mode, Rollo lists the destinations available for your account and the fields each option requires.

Creating a payout is done in Dashboard → Payouts. The public API supports listing payouts and payout methods so you can sync books — not POST /v1/payouts.

Settlement

Successful payments create settlement entries. Funds become withdrawable within five business days at 10:00 in your settlement timezone (processor settlement window). Disputes can hold balances until resolved. In Dashboard → Payouts, merchants see pending vs available balance, next release time, and a settlement activity list with each payment's availability date — then withdraw when funds are ready.

Identity verification

Live payouts require Rollo account approval plus payout identity verification. Complete both before connecting a bank or wallet in Live mode. Sandbox works without verification.

Connect a destination

From Payouts → Connect destination, choose a method, complete required fields, and set a default if you want automatic payouts.

List payout methods

Example request

GET /v1/payout_methods
Authorization: Bearer rk_live_...

Example response

{
  "object": "list",
  "data": [
    {
      "id": "pmth_...",
      "object": "payout_method",
      "label": "Chase ****4242",
      "currency": "usd",
      "delivery_type": "bank",
      "last4": "4242",
      "supports_instant": false,
      "supports_standard": true,
      "created": 1722500000000
    }
  ]
}

How to handle it

Use to show which destinations are connected in your ops tools. Create / edit destinations only in the dashboard.

List payouts

Example request

GET /v1/payouts
Authorization: Bearer rk_live_...

Example response

{
  "object": "list",
  "livemode": true,
  "data": [
    {
      "id": "po_...",
      "object": "payout",
      "amount": 50000,
      "currency": "usd",
      "status": "paid",
      "speed": "standard",
      "created": 1723100000000,
      "livemode": true
    }
  ]
}

How to handle it

Statuses move through pending, in_transit, paid, failed. Prefer webhooks for real-time updates.

Webhook: payout.paid

Example request

# Fired when funds land (not merely when submitted)

Example response

{
  "id": "evt_...",
  "type": "payout.paid",
  "created": 1723200000,
  "data": {
    "id": "po_...",
    "amount": 50000,
    "currency": "usd",
    "status": "paid"
  }
}

How to handle it

Mark the payout settled in your books. Also subscribe to payout.failed and payout.canceled.

Fees

Network fees plus platform withdrawal markups apply when you withdraw. Typical markups: next-day bank 1% + $0.50, instant 1.5% + $1, wire 1% + $15, digital wallet 1.5% + $0.50, crypto 2% + $1.