> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paynext.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Unlimit

> Accept payments via Unlimit with PayNext.

Unlimit is a global fintech providing multi-currency card acquiring across Europe, Latin America, and Asia.

## Processor Details

|                          |                                                                                            |
| :----------------------- | :----------------------------------------------------------------------------------------- |
| **Payment Methods**      | <Badge>Cards</Badge> <Badge>Apple Pay</Badge> <Badge>Google Pay</Badge>                    |
| **Supported Currencies** | [Currency list](https://docs.gatefi.com/docs/gatefi-docs/hyjdn5kx9p84j-supported-payments) |
| **Metadata Mapping**     | ✓                                                                                          |
| **Network Tokens**       | ✓ (Contact your Unlimit representative to enable)                                          |
| **3DS Support**          | ✓                                                                                          |
| **3RI Support**          | ✗                                                                                          |
| **ARN**                  | ✓                                                                                          |
| **Fraud Signals**        | ✓ (PayNext retrieves fraud reports from Unlimit)                                           |

## Integration Guide

<Steps>
  <Step title="Open Unlimit Merchant Admin">
    Log in to the [Unlimit Merchant Admin](https://sandbox.unlimit.com/ma-new/#/dashboard) and navigate to **Settings → Wallets**
  </Step>

  <Step title="Copy credentials">
    Locate the wallet you want to use and copy its **Wallet ID** and **Terminal Code**. Then open the wallet, scroll to **Credentials**, click **Show credentials**, and copy the **Terminal Password**

    <Note>
      Different wallets support different currencies and payment methods. Select the wallet that matches your requirements.
    </Note>
  </Step>

  <Step title="Add integration in PayNext">
    In **Dashboard → Integrations**, click **Add new integration → Unlimit → Connect**
  </Step>

  <Step title="Enter credentials">
    * **Name**: Label for this connection (e.g., "Unlimit EU")
    * **Wallet ID**, **Terminal Code**, **Password**: Values from Unlimit
    * **Network Tokens**: Enable if activated by your Unlimit account manager
  </Step>

  <Step title="Save">
    Click **Connect** to complete the integration
  </Step>
</Steps>

## CPF/CNPJ for Brazilian Cards

PayNext can collect and send **CPF/CNPJ** for card payments processed via Unlimit when the card is issued by a Brazilian bank.

### How to enable

<Steps>
  <Step title="Open Checkout">
    In the PayNext Dashboard, go to **Checkout**.
  </Step>

  <Step title="Open Card settings">
    In the payment methods list, select **Card** to open **Card Settings**.
  </Step>

  <Step title="Turn on CPF/CNPJ collection">
    Enable **Collect CPF/CNPJ for Brazilian cards**.
  </Step>

  <Step title="Publish">
    Click **Publish** to apply the changes.
  </Step>
</Steps>

### How it works

When the customer enters a card, the SDK checks whether the card was issued by a Brazilian bank.

If the card is identified as Brazilian, an additional required field appears in the checkout form: **CPF or CNPJ**.

After the customer enters a valid value:

* the field is sent to Unlimit on the initial **CIT** payment
* the same value is reused for all subsequent **MIT** payments for that customer, as long as the saved payment method is still a Brazilian-issued card

### Important behavior

* CPF/CNPJ is collected and required only when the checkout detects a Brazilian-issued card
* If the customer later updates the saved payment method to a **non-Brazilian card**, CPF/CNPJ is no longer sent to Unlimit
* PayNext sends CPF/CNPJ to Unlimit only when the customer has a saved **card** payment method and that card is issued by a Brazilian bank

## Metadata Mapping

Unlimit supports metadata mapping for authorization. Forward custom descriptors to control what appears on customer bank statements or pass additional context for reconciliation.

<Info>
  The `dynamic_descriptor` field must be enabled by your Unlimit account manager before use. Contact Unlimit support to activate this feature.
</Info>

**Supported Fields:**

| Metadata Key        | Target Field                        | Character Limit    | Description                                 |
| :------------------ | :---------------------------------- | :----------------- | :------------------------------------------ |
| `store_descriptor`  | `recurring_data.dynamic_descriptor` | 25 (Visa), 22 (MC) | Primary descriptor shown on bank statements |
| `payment_note`      | `recurring_data.note`               | 100                | Internal note (not shown to customer)       |
| `order_description` | `merchant_order.description`        | 200                | Order description                           |

<Warning>
  Dynamic descriptor limits:

  * Visa cards: 25 characters maximum
  * MasterCard: 22 characters maximum
  * Use the shorter limit (22) to ensure compatibility across all card types
</Warning>

**Example Usage:**

```json theme={"system"}
PATCH /customers/:id
{
  "metadata": {
    "store_descriptor": "MYSTORE NYC"
  }
}
```

Configure mapping in **Dashboard → Integrations → Unlimit → Metadata mapping**:

* **Key:** `store_descriptor`
* **Value:** `recurring_data.dynamic_descriptor`
* **Operation:** Authorization

The descriptor will appear on all future payments for this customer.

**Best Practices:**

* Keep descriptors under 22 characters for universal compatibility
* Use uppercase and avoid special characters
* Test in sandbox to verify statement appearance
* Contact Unlimit support to enable `dynamic_descriptor` for your account

<Note>
  Metadata mapping only applies to authorization requests. Capture operations do not support descriptor changes in Unlimit.
</Note>

## External 3DS Configuration

If your processor requires **external 3DS data**, configure it in **Dashboard → Integrations → Unlimit → 3DS**. See [Configure External 3DS](/guides/payments/3d-secure#configure-external-3ds-per-processor) for setup instructions.

## Testing

[Unlimit testing guide](https://integration.unlimit.com/doc-guides/2l40g4chbu7et-card-methods) — Test cards and payment scenarios.