Payout Status Webhook

Receive UQPay payout status change events. Payouts are processed asynchronously after creation; final results are delivered via this webhook.

Event types:

payout.ready.send: Payout ready to send (INIT -> PROCESSING)

payout.completed: Payout successful (-> SUCCESS) - unfreeze + deduct, fee record created

payout.failed: Payout failed (-> FAILED) - unfreeze and refund, no deduction

payout.compliance.rejected: Compliance rejected (-> FAILED) - unfreeze and refund, no deduction

data fields:

payout_id: Unique payout id (UUID)

status: Payout status

fee_amount: Provider fee (returned on completed)

fee_currency: Fee currency (returned on completed)

account_id: UQPay account id

Fee notes (on payout.completed):

Total fee = system fee (calculated at creation) + provider fee (returned in webhook)

Beneficiary receives = user payout amount - total fee

The user is only debited the payout amount (no extra charges); fees are split internally

Note: This endpoint is called by UQPay servers and does not require JWT auth.

curl --location '/receive/webhook/uqpay/payout' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "version": "1.0", "event_name": "VIRTUAL", "event_type": "string", "event_id": "string", "source_id": "string", "data": { "property1": "string", "property2": "string" } }'

Payout Status Webhook

Request

Responses