> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs-colombia.wallib.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs-colombia.wallib.io/_mcp/server.

# Introduction

# 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}}`.