Welcome to the Wallib Payments API

Integrate crypto-to-fiat payments and payouts directly into your mobile or web applications with support for USDT on the TRON network and fiat disbursements in Colombian pesos (COP).

Supported payout destinations include bank accounts, mobile wallets (Nequi, DaviPlata), Bre-B payments, and more — all reachable through a single, unified API.

Support for additional blockchain networks and currencies (Polygon, Ethereum, Solana) is planned for future releases.

What you can do

The Wallib Payments API provides a focused set of REST endpoints for authenticating, quoting, funding, and tracking off-ramp payments to local destinations in Colombia.

Using these endpoints, you can:

Authenticate as a provider and obtain a JWT token to authorize API calls.
Retrieve exchange rates between USDT and COP before initiating a payment.
Discover available payment methods supported for payout destinations.
Generate payment quotes for different payout types — bank accounts, Bre-B keys, and mobile wallets — with recipient details and conversion amounts.
Accept a quote by confirming the on-chain transaction hash, triggering the off-ramp payout process.
Track transactions in real time by querying their current status and details.
Register a webhook to receive automated event notifications when a transaction changes state.
Simulate webhook events to test your integration against all possible transaction lifecycle states.

Endpoints at a glance

Endpoint	Method	Description
`/third/v1/authentication`	POST	Authenticate and obtain a JWT token
`/third/v1/provider/exchangerates`	POST	Get real-time USDT/COP exchange rates
`/third/v1/providers/paymentmethods`	GET	List available payout methods
`/third/v1/provider/quote`	POST	Generate a quote (bank account, Bre-B, or mobile wallet)
`/third/v1/provider/quote`	PUT	Accept a quote and initiate the payout
`/third/v1/provider/transaction/:id`	GET	Retrieve transaction status and details
`/third/v1/provider/webhook`	POST	Register a webhook URL for event notifications
`/third/v1/provider/webhook/transactions`	POST	Simulate a webhook event for testing

Authentication

All endpoints require an x-api-key header. Protected endpoints additionally require a Bearer token obtained from the Authentication endpoint, passed as Authorization: Bearer {{JWT_LOGIN}}.