Documentation Index
Fetch the complete documentation index at: https://docs.winampay.de/llms.txt
Use this file to discover all available pages before exploring further.
Deposit states
| State | Description |
|---|
pending | Transaction created, USSD being sent |
provider_acknowledged | USSD sent — player has received the notification on their phone |
succeeded | Player confirmed with PIN — payment received on merchant SIM |
failed | Player refused, timeout, or provider error |
expired | Confirmation window (expires_at) passed without player confirmation |
Withdrawal states
| State | Description |
|---|
pending_approval | Awaiting manual approval from a Winam operator |
approved | Approved — being submitted to the provider |
provider_submitted | USSD transfer sent — awaiting provider confirmation |
succeeded | Transfer confirmed by the provider — player received funds |
failed | Rejected by operator, provider refusal, or insufficient SIM balance |
requires_manual_resolution | Transaction stuck — human intervention required (escalated automatically after 1 hour) |
Terminal states
All three terminal states — succeeded, failed, requires_manual_resolution — trigger a webhook to your callback_url:
| Event | Terminal state |
|---|
payment.succeeded | succeeded |
payment.failed | failed or requires_manual_resolution |
