Skip to main content
Unlimit is a global payment platform that provides comprehensive card processing solutions. The platform supports card payments with advanced features like delayed capture, partial refunds, digital wallet integration, and 3-D Secure authentication across multiple currencies and countries.

​
Setup

To set up Unlimit in the dashboard, configure the following credentials from your Unlimit merchant account:
  • Terminal Code - Find in dashboard under Settings -> Terminal -> Terminal Code
  • Password - Find in dashboard under Settings -> API Credentials -> Password
  • Callback Secret - Find in dashboard under Settings -> Webhooks -> Secret Key

​
Connector configuration

After setting up your Unlimit connector in the dashboard, configure how transactions are routed to it. Choose one of the following options:
  • Using Flow - Configure Unlimit as the target connector in Flow to automatically route card transactions to this connector
  • Using the API - Explicitly set the payment_service_id parameter to the Unlimit connector ID when creating transactions. This overrides any Flow routing rules.
The connector ID can be found in the dashboard under Connections -> Configured connections.
By default, Unlimit requires CVV for all transactions. This prevents the following use cases:
  • Recurring payments with stored tokens—Merchant-initiated transactions (MIT) use stored payment methods without CVV, causing these transactions to fail.
  • Google Pay on web—Google Pay on web does not provide CVV, so these payments are blocked.
Contact Unlimit to request removal of the CVV requirement on your account to support these scenarios.

​
Required fields

Unlimit requires the buyer’s billing email address and statement descriptor with every transaction. This data helps identify and validate the transaction.
  • buyer.billing_details.email_address - The buyer’s email address
  • statement_descriptor.description - The text that appears on the buyer’s card statement

​
Features

Unlimit supports the following features:
  • Delayed capture - Authorize a payment and capture it at a later time
  • Partial capture - Capture a portion of the authorized amount
  • Partial refunds - Refund a portion of the captured amount
  • Void - Cancel an authorized transaction before capture
  • Zero auth - Verify a card without charging it
  • Digital wallets - Support for Apple Pay, Google Pay (Limited), and other digital wallet integrations
  • Network tokens - Using network-level tokenization for enhanced security and approval rates
  • 3-D Secure - Support for pass-through 3DS authentication
  • Payment method tokenization - Store payment methods for future recurring payments
  • Transaction synchronization - Keep transaction status in sync with Unlimit’s system

​
Supported countries

Unlimit supports transactions from buyers in the following countries:
Country codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry code
AEAOARATAUAZBEBG
BHBRBYCACHCLCNCO
CRCYCZDEDKEEEGES
FIFRGBGHGRGTHKHR
HUIDIEILINITJPKE
KRKWKZLTLULVMAMD
MNMTMXMYMZNGNLNO
NZOMPEPHPKPLPTQA
RORSRUSASESGSISK
THTRTWTZUAUGUSUY
UZVNZA

​
Supported currencies

Unlimit supports processing payments in the following currencies:
Currency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency code
AEDAOAARSAUDAZNBHDBRLBYN
CADCHFCNYCOPCRCCZKDKKEGP
EURGBPGTQHKDHUFIDRILSINR
JPYKESKRWKWDKZTMADMDLMNT
MXNMYRMZNNGNNOKNZDOMRPHP
PKRPLNQARRONRSDRUBSARSEK
SGDTHBTRYTWDTZSUAHUSDUZS
VNDZAR

​
Limitations

The following features are not supported by this connector:
  • Hosted 3-D Secure - 3DS authentication must be handled externally and passed through (pass-through only)
  • Google Pay on web - Not supported by default because Unlimit requires CVV, which Google Pay on web does not provide. To enable this, request Unlimit to remove the CVV requirement on your account.
  • Over-capture - Capturing more than the authorized amount is not supported
  • Partial authorization - Authorizing only a portion of the requested amount is not supported
  • Incremental authorization - Increasing an existing authorized amount is not supported
  • Issuer-based installments - Installment plans managed by the card issuer are not supported
  • Settlement reporting - Detailed settlement and reconciliation reports are not available
This is a closed-loop connector. Some failover scenarios are limited. For details, see Open loop versus closed loop.

​
Integration

To accept card payments with Unlimit, use one of Gr4vy’s client-side integration methods to securely collect card details. Due to PCI compliance requirements, card data should never be sent directly to your servers. You can integrate using:
  • Embed - A pre-built, customizable payment form that handles the complete payment flow
  • Secure Fields - Embed card input fields for building custom payment forms while maintaining PCI compliance
  • Mobile SDKs - Native SDKs for iOS, Android, React Native, and other platforms
These methods handle card data collection and tokenization. Once the card details are collected and tokenized, create a transaction through the Gr4vy API, which automatically routes the payment to your configured Unlimit connection based on your Flow rules or explicit payment_service_id parameter.

​
Webhooks

Unlimit sends webhooks to notify you of transaction status changes. Make sure to configure your webhook endpoint in the Unlimit dashboard so that Gr4vy can receive real-time transaction updates and keep transaction statuses in sync. To configure webhooks in Unlimit:
  1. Log in to your Unlimit merchant dashboard
  2. Navigate to Settings -> Webhooks
  3. Add the following webhook endpoint configured for you by Gr4vy
  4. Enable notifications for transaction events
Enable your Gr4vy instance’s webhook URL to receive notifications about transaction status changes, refunds, and voids.
Webhook setup is required for this connector to function properly. Without webhooks enabled, transaction status updates may be delayed.

​
Testing

For testing in sandbox environments, you can use standard test card numbers. Unlimit supports industry-standard test cards for simulating different transaction scenarios: Successful transactions:
  • Visa: 4111 1111 1111 1111
  • Mastercard: 5555 5555 5555 4444
  • American Express: 3782 822463 10005
Use any future expiry date and any 3-digit CVV (4 digits for American Express). For more test scenarios and additional card numbers, contact your Unlimit representative.