Withdrawals
Initiate a Mobile Money withdrawal. Requires manual approval by a Winam operator before execution.
How it works
Call POST /withdrawals
reference.Queued for approval
pending_approval state. A Winam operator reviews and approves (or rejects) it from the operator dashboard.Transfer executed
Webhook fired
callback_url receives a POST with event: "payment.succeeded" or "payment.failed".Approval time
Manual approvals typically happen within minutes to a few hours during business hours. Yourcallback_url will be notified as soon as the outcome is known.
If no callback_url is provided, poll GET /api/v1/transactions/{winam_tx_id} for status updates.
Response states
Authorizations
Body
Player UUID on the sportsbook side
Recipient MoMo number (E.164)
"+237670123456"
Amount in XAF (min 100)
x >= 100MoMo operator
"mtn"
"orange"
Unique sportsbook reference
1 - 128POST URL for withdrawal result notification.
Response
Successful Response
Winam internal transaction UUID. Use this with GET /api/v1/transactions/{id}.
Your idempotency key, echoed back from the request
pending_approval — the withdrawal is queued for manual approval by a Winam operator. Your platform will be notified via webhook when the status changes.
"pending_approval"
Amount in XAF
10000
"mtn" or "orange"
"mtn"

