Integration

Mangoplay offers agents two integration options: Seamless Mode and Transfer Mode.

Integration Mode

Seamless

In Seamless Mode, the credit wallet is managed within the agent's system. The Mangoplay system will generate events that notify the agent's system when users perform actions such as placing bets, voiding bills, or when bills are settled or voided.

The following webhooks are required to integrate with our system through the open api:

Create player : Our system allow you to create the player
Play game : Our system will generate the URL with token to play the game
Edit Password : Our system allow you able to update the player password

In Seamless Mode you also expose a callback endpoint that Mangoplay calls for every bet and every settlement. The contract for that endpoint, including idempotency and retry behaviour, is documented on the Wallet Callback page — please read it before you start building.

For more details please visit : Agent API Docs

Transfer

In Transfer Mode, the credit wallet is managed by the Mangoplay system. Agents are required to adjust user credits by interacting with the Mangoplay API, which is used for both credit deposits and withdrawals.

The following API endpoint must be called to integrate with our system:

Create player : Our system allow you to create the player
Play game : Our system will generate the URL with token to play the game
Sign out : Our system allow you to terminate the session of your users
Edit Password : Our system allow you able to update the player password
Edit Player Status : Our system allow you able to update the player status
Edit Player bet limit : Our system allow you able to update the player bet limit (see Bet Limits below)
Deposit player credit : Our system allow you able to deposit the player credits
Withdraw player credit : Our system allow you able to withdraw the player credits

For more details please visit : Agent API Docs

Webhook

We also provide you with a webhook testing tool through Swagger, ensuring that our platform is compatible with your system. please visit : Webhook Swagger

Bet Limits

Bet limits are the ranges your players pick from in the game lobby. MangoPlay sets a ceiling per game for your agent; inside that ceiling you control the ranges yourself, without raising a ticket. This works the same in Seamless and Transfer mode.

There are two levels, and both are read and written with the Bet Limit APIs:

Agent-wide : one set of ranges per game, applied to every player under your agent
Per player : ranges for a single player, which win over the agent-wide value and over any tier we set for them

Three things are worth knowing before you build against it:

You can only set values inside the MangoPlay ceiling. GET /api/v1/open/config/betLimits returns the ceiling for every game alongside the current value. A request above it is rejected and lists every game that failed — and nothing is written, not even the games that would have passed.
Games you do not send are left alone. Send only what changes; there is no need to resend your whole configuration, and no risk of wiping a game by omitting it. Send reset: true for a game to drop your value and go back to our default.
source tells you which level a value came from — PLAYER, TAG (a tier we set), AGG (your agent-wide value) or MANGOPLAY (our default). Check it first when a value you set does not appear to take effect.

New limits apply the next time the player enters a game.

For more details please visit : Agent API Docs

Reconciliation

Network timeouts happen. When a bill ends up in a different state on your side than on ours — a bet showing as failed although you debited it, or a settle still pending although the round is over — you can inspect and close it yourself with the Reconciliation APIs rather than raising a ticket:

betInfo : shows the bet, its settle status, and the last request/response we exchanged with you for that deal
reSettle : flips a bet we marked failed to success and settles it, idempotently

For more details please visit : Agent API Docs