# PIX Payin (BRL→ USDT)

<figure><img src="/files/swp0zmHqNbwgfME6QmmB" alt=""><figcaption></figcaption></figure>

#### API Reference — PIX (BRL → USDT)

This section provides a reference for integrating Tylt CrossRamp’s PIX on-ramp flow within merchant applications. Through this integration, end users can initiate BRL transfers via PIX, which are used to facilitate the acquisition of stablecoins. The resulting USDT is transferred to the merchant’s Tylt wallet.

***

#### Settlement Models

This service supports two settlement configurations:

**1. Daily Settlement**

* Stablecoin balances are updated following successful transaction completion
* Balances are aggregated and reconciled through a daily settlement cycle
* Funds are reflected in the merchant’s Tylt wallet balance

***

**2. Instant Settlement**

* Stablecoins are transferred directly to a merchant-provided self-hosted wallet on a per-transaction basis
* No balance is maintained within Tylt for these transactions
* Network fees may apply due to on-chain transfers

***

At onboarding, merchants are configured with separate settlement modes. Each mode is associated with dedicated wallet configurations and API credentials. For Instant Settlement, the merchant must provide a self-hosted wallet address for direct settlement of funds.

***

### What You’ll Find in the API Reference

**1. PIX On-Ramp Flow**\
Guidance for enabling end users to initiate BRL transfers via PIX and complete on-ramp transactions, including transaction lifecycle tracking and settlement visibility.

**2. Endpoint Descriptions**\
Detailed specifications for all API endpoints, including parameters, authentication requirements, and sample requests.

**3. Request & Response Formats**\
Structured JSON examples covering on-ramp creation, status retrieval, webhook payloads, and error handling.

**4. Code Examples**\
Reference implementations in Node.js, Python, and other commonly used stacks.

**5. Error Handling**\
Common error scenarios, causes, and recommended handling strategies to ensure reliable integration.

***

#### Summary

This API enables merchants to embed PIX-based on-ramp functionality, allowing end users to acquire stablecoins via local payment methods, with settlement managed in USDT through Tylt’s crypto-asset infrastructure.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tylt.money/introduction/tylt-crossramp-fiat-crypto-solutions/brazil-brl/pix-payin-brl-usdt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.