API Pix (1.0)

Swagger

Environments

Staging Environment: https://api.sdb.lbpay.com.br

Production Environment: Provided once you complete the testing

---

This document provides the technical specifications for integrating with our PIX API, designed for iGaming platforms. Follow the guidelines below to ensure a successful implementation.

Authentication

We use the OAuth 2.0 standard with Bearer Tokens. You must request an access token by sending your credentials to the authentication endpoint.

Replace the client_id and client_secret

curl --request POST \
  --url 'http://seamless-v2.stg.lbpay.com.br/v1/oauth2/token' \
  --header 'accept: application/json' \
  --header 'content-type: multipart/form-data' \
  --form client_id=YOUR_CLIENT_ID \
  --form grant_type=client_credentials \
  --form client_secret=YOUR_CLIENT_SECRET

---

Terminology

• PIX Processor: London Bridge, acting as the Banking-as-a-Service (BaaS) provider responsible for processing PIX transactions.
• Gaming Operator: The iGaming platform integrating with this API.
• Deposit (Pix-In): When a player initiates a deposit request, an invoice is generated as a PIX QR Code or copy-and-paste payload. The player pays this invoice to credit their gaming wallet.
• Withdrawal (Pix-Out): When a player requests a withdrawal, a PIX transfer (cash-out) is executed to the player’s bank account.
• Refund: Returning the funds of a previously completed deposit back to the player.
• Internal Transfer: Instantaneous transfers between gaming wallets.

---

API Controllers

Note: All API requests must be prefixed with /v1 in the URL path.

Controller	Description
Pix-In	Core endpoints for creating and retrieving player deposit transactions.
Pix-Out	Core endpoints for initiating and querying player withdrawal transactions.
Pix Refund	Endpoints used to return funds from previously completed deposits.
Internal Transfer	Endpoints that manage wallet‑to‑wallet transfers within the operator’s environment.
Webhook	Endpoints used to configure callback URLs and receive asynchronous notifications from the platform.
Balance	Endpoints for querying account balances, including real-time and closing-day balances.

Webhook Notifications

Operators must implement a webhook endpoint capable of receiving real-time notifications from our platform. Whenever a transaction changes status (e.g., a deposit is confirmed), a webhook event is sent to the URL configured by the operator.

Webhook configuration and management can be handled through the Webhook endpoints available in this API.

Our notification system includes automatic retry logic. However, to ensure full reconciliation of events, we strongly recommend maintaining a fallback polling mechanism to retrieve any undelivered status updates in the event your service becomes temporarily unavailable.

---

Customer Journey for Deposits

1. The player logs into the gaming operator’s platform and selects Pix as the deposit method. 2. The player chooses a predefined amount or enters a custom deposit value. 3. The operator generates a Pix charge (QR Code and Copy-and-Paste payload) using the POST /v1/pix/deposit/immediate-charge endpoint. 4. The player scans the QR Code or pastes the payload into their banking app to complete the payment. 5. Our platform processes the transaction and sends a real-time webhook notification to the operator with the final status. 6. Upon receiving the notification, the operator immediately credits the player’s gaming wallet.

---

Customer Journey for Withdrawals

1. The player submits a withdrawal request from their gaming wallet. 2. The player provides the Pix key associated with their bank account (CPF, email, phone number, or random key). 3. After validating the player’s balance and compliance rules, the operator sends a withdrawal request through the POST /v1/pix/withdraw endpoint, including the Pix key and the requested amount. 4. Our API processes the Pix cash-out and transfers the funds to the player’s bank account within seconds. 5. A real-time webhook notification is sent to the operator confirming the successful settlement of the withdrawal.

---