Payout requests API overview

​

Key concepts

• Payout request ID: a numeric id returned when the request is created. Use it to get, approve or mark the request as paid.
• Gateway: how the partner is paid: paypal, wise, crypto or venmo.
• Payout settings: the partner’s payment details for the gateway (for example their PayPal email). You can send them when creating a payout request.
• Status: where the request is in its lifecycle (see Status values).

​

Available endpoints

​

Lifecycle

1. Create: the request starts as requested. Partner portal requests and requests from automations appear here too.
2. Approve: the status becomes approved and the partner gets the approval email. If automated payouts are enabled, the payout may then be scheduled, and the status changes to one of the *_scheduled values.
3. Mark as paid: once you’ve paid the partner outside Partnero, the status becomes finished. The payout’s commissions are marked as paid and the partner gets the “payout sent” email.

​

The payout request object

{
  "id": 555,
  "partner": "partner_123",
  "status": "requested",
  "amount": 200.0,
  "amount_units": "usd",
  "payout_gateway": "paypal",
  "created_by": "api",
  "created_at": "2026-09-29T10:15:00.000000Z",
  "updated_at": "2026-09-29T10:15:00.000000Z"
}

​

Status values