> For the complete documentation index, see [llms.txt](https://rumbapay.gitbook.io/payments/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rumbapay.gitbook.io/payments/readme.md).

# Welcome

Welcome to the Rumbapay Payments API!

Our API enables you to accept and process payments across multiple methods with global coverage. This documentation will guide you through:

1. **Getting Started**
   * [Authentication](/payments/getting-started/authentication.md)
   * [Signature](/payments/getting-started/signature.md)
2. **Payment Methods**
   * **Argentina – Bank Transfer**
     * [Payment](/payments/payment-methods/argentina/bank-transfer-argentina/payment.md)
     * [Payout](/payments/payment-methods/argentina/bank-transfer-argentina/payout.md)
   * **Brazil – PIX**
     * [Payment](/payments/payment-methods/brazil/pix/payment.md)
     * [Payout](/payments/payment-methods/brazil/pix/payout.md)
   * **Bank transfer Mexico**
     * [Payment](/payments/mexico/bank-transfer-mexico/payment.md)
     * [Payout](/payments/mexico/bank-transfer-mexico/payout.md)
   * **Cash Mexico**
     * [Payment](/payments/mexico/cash/payment.md)
   * **Cash Chile**
     * [Payment](/payments/payment-methods/chile/cash.md)

#### Authentication & Security

All API requests must include an `access-token` header generated via HMACSHA256 using your merchant key and login, and a `signature` header on every request and response to ensure payload integrity.

#### Payment & Payout Workflows

* **Argentina (bank\_transfer\_argentina)**
  * **Payment**: Supports both server-to-server (H2H) and hosted payment page (HPP) flows, determined by `challenge.challenge_type` in the response.
  * **Payout**: Use the Payout API (`/v1/payout`) to send funds directly to customer bank accounts.
* **Brazil (PIX)**
  * **Payment**: Returns either a QR code string (`challenge.challenge_qr.code`) for in-app scanning or a redirect URL (`challenge.challenge_redirect.url`).
  * **Payout**: Send funds instantly to a PIX account using the `payout` endpoint.
* **Chile (cash)**
  * **Payment**: Supports hosted payment page (HPP) flow
* **Mexico (cash,  bank\_transfer\_mexico)**
  * **Payment**: Supports hosted payment page (HPP) flow for methods `cach`and `bank_transfer_mexico` 
  * **Payout**: Use the Payout API (`/v1/payout`) to send funds directly to customer bank accounts

#### Next Steps

1. Obtain your merchant **login** and **key** from the Rumbapay dashboard.
2. Review the **Authentication** and **Signature** guides to secure your integration.
3. Choose your payment method and follow the detailed flow.
4. Monitor transactions via the **Check Payment Status** endpoint and handle callbacks to stay updated on payment outcomes.

Let's get started 🚀