search
Ctrlk

PIX Payin (BRL→ USDT)

hashtag
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.

hashtag
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.

hashtag
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.

hashtag
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.

PreviousBrazil (BRL)NextCreate a Pay-in Instance

Last updated