# Winam Payments API

## Docs

- [Authentication](https://docs.winampay.de/api-reference/authentication.md): How to authenticate requests to the Winam Payments API.
- [Callback Public Key](https://docs.winampay.de/api-reference/callback-public-key.md): Returns the RSA public key used to sign outbound webhook notifications.
- [Changelog](https://docs.winampay.de/api-reference/changelog.md): API version history and breaking changes.
- [Deposits](https://docs.winampay.de/api-reference/deposits.md): Initiate a Mobile Money deposit. The player receives a USSD notification to confirm with their PIN.
- [Errors](https://docs.winampay.de/api-reference/errors.md): HTTP error codes and standard error response format.
- [Idempotency](https://docs.winampay.de/api-reference/idempotency.md): How the reference field prevents duplicate transactions on retries.
- [Detect Operator](https://docs.winampay.de/api-reference/msisdn-detect.md): Detect the Mobile Money operator from a phone number. Use this to pre-fill the operator field without asking the player.
- [Overview](https://docs.winampay.de/api-reference/overview.md): Mobile Money payment abstraction layer for Cameroon. Integrate MTN MoMo and Orange Money in minutes.
- [List Player Transactions](https://docs.winampay.de/api-reference/player-transactions.md): Returns paginated transaction history for a player, sorted newest first.
- [Providers Overview](https://docs.winampay.de/api-reference/providers.md): Mobile Money providers available through winam-payments, and how to use them.
- [List Providers](https://docs.winampay.de/api-reference/providers-list.md): Returns available Mobile Money providers for a country, with fees and availability.
- [Provider Health](https://docs.winampay.de/api-reference/providers-status.md): Real-time health status for each Mobile Money provider, including failure rate over the last hour.
- [Replay Callback](https://docs.winampay.de/api-reference/replay-callback.md): Manually re-fires the webhook for a completed transaction. Use for incident recovery when your callback_url was temporarily unavailable.
- [State Machine](https://docs.winampay.de/api-reference/state-machine.md): Transaction lifecycle — all possible states and transitions.
- [Get Transaction](https://docs.winampay.de/api-reference/transaction-get.md): Returns the full state and metadata of a payment transaction.
- [Polling vs. Webhooks](https://docs.winampay.de/api-reference/transactions.md): When to poll for transaction state vs. relying on webhook notifications.
- [Webhooks](https://docs.winampay.de/api-reference/webhooks.md): Receive and verify payment outcome notifications from winam-payments.
- [Withdrawals](https://docs.winampay.de/api-reference/withdrawals.md): Initiate a Mobile Money withdrawal. Requires manual approval by a Winam operator before execution.

## OpenAPI Specs

- [openapi](https://docs.winampay.de/openapi.json)