Book a Demo

Unlimint - Cards

Suggest Edits

This page presents all information related to the Unlimint connection using Cards as payment. Use the following buttons to navigate to the desired section.

General Information

Captures

Refunds

Voids

Installments

Chargebacks

Security

Testing Guidelines

Integration Configuration

Production Environment

Connecting with Yuno

Mandatory fields when integrating via Yuno:

email
IP
card_holder_name>
*However, there is a possibility that the provider requests additional fields according to the merchant or to improve the approval rate

General information

Countries:

For low risk all countries are supported for Visa/MC except Cuba, Iran, The Sudan, Syria, Venezuela, Myanmar, Korea (the Democratic People's Republic), Western Sahara, Kosovo, Nicaragua, Afghanistan, Yemen, Mali, Zimbabwe and South Sudan. For each high risk category the list of countries is different.

Currencies:

Shopper can pay in any currency, but card must be linked to EUR or USD (Unlimint issuing Visa / MasterCard cards in EUR or USD currencies).
For all card transactions in a currency other than Card currency, conversion of the amount takes place at the prevailing exchange rate of the relevant Card Association with a 3% mark up (currency exchange fee). The variable Card Association rate and currency exchange fee is applied without notice at the date and time when the relevant Card Association processes the transaction, which may be different from the transaction date.

Payment methods:

Credit card
Credit card
debit card
Debit card
Prepaid card
Prepaid card

Maximum amount:

25000 EUR/USD

TRX limit:

No limit.

International BIN:

On local acquiring BRL only BRL Bins area accepted, on Mexican only MXN. Generally, on international acquiring, opened BINs depend on business vertical.

TRX without CVV:

Yes

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

Yes

Support for recurrency:

Yes

Particularities:

Supported recurrent payments:
  • One-click payments
  • Scheduled payments

Webhooks:

Yes

Captures

Partial capture:

No

Multiple captures:

No

Maximum time to capture an authorization:

If merchant doesn't send complete, payment will be completed automatically in 7 calendar days by default. However, it is configurable with Unlimint.

Captures over the amount of authorization:

No

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refunds:

Yes

Time to request refund:

No restrictions.

Time to process refund:

From Unlimint, the request for a refund goes away instantly, and the rest depends on the client's bank.

Voids

Void support:

Yes

Void to authorization:

Yes

Void to refund:

Yes

Installments

Capability to define the installments when creating the payment:

Yes. Important: To enable Installment payments please contact Unlimint support/manager

GET endpoint available for retrieving the permitted BIN for the installments:

No

Possibility to choose who will be responsible for financing installments:

Yes

Conditions or restrictions:

Important: countries in description below - are card issuer countries

Mexico
  • Installment payments type in use: Issuer financed (IF).
  • Supported cards:
  • Brand: MasterCard, Visa, Amex, Carnet (and subbrands)
  • Type: credit cards
  • Available Installment payments numbers: 3, 6, 9, 12, or 18
Brazil
  • Installment payments type in use: Merchant financed (MF_HOLD).
  • Supported cards: Only credit cards.
  • Available Installment payments numbers: 2-12

Grace period:

Available for suscriptions.

Minimum number of Installments (#months):

  • Mexico: 3
  • Brasil: 2

Maximum number of Installments (#months):

  • Mexico: 18
  • Brasil: 12

Chargebacks

Notifications of chargebacks:

Yes

Defined period to make a chargeback:

It depends on the type of chargeback and card scheme, but for consumer disputes, it's usually 120 days from the transaction/delivery date (the maximum timeframe is 540 days from the transaction date).

Endpoint for disputes:

Yes

Maximum time to dispute a chargeback (provide evidence):

Merchant has 10 days to provide Unlimint with a decision regarding the received chargeback via Dashboard.

Security

Address verification service:

AVS (address verification service) is applicable to UK and US billing addresses only.

Support for 0Auth:

No

E3DS v2:

Yes

Testing guidelines for sandbox environment

Necessary fields for testing:

Terminal ID, Terminal Password and Callback Secret.

Visa test cards:

Card PAN 3-D Secure result Transaction result
4000000000000085 3-D secure version 2, challenge flow, full authentication Payment has CONFIRMED status
4580000000000059 3-D secure version 2, frictionless flow, attempt Payment has CONFIRMED status
4000000000000093 3-D secure version 2, frictionless flow, success Payment has CONFIRMED status
4000000000000051 No 3-D Secure Payment has AUTHORIZED status
4000000000000077 No 3-D Secure Payment has CONFIRMED status
4444444444444455 3-D secure version 2, challenge flow, full authentication Payment has DECLINED status
4444444444449777 No 3-D Secure Payment has DECLINED status

Maestro test cards:

Card PAN 3-D Secure result Transaction result
5000000000000025 3-D secure version 2, challenge flow, full authentication Payment has CONFIRMED status
5000000000000033 3-D secure version 2, frictionless flow, success Payment has CONFIRMED status
5666666666666955 3-D secure version 2, challenge flow, full authentication Payment has CONFIRMED status

Discover test cards:

Card PAN 3-D Secure result Transaction result
6500000000000895 3-D secure version 2, challenge flow, full authentication Payment has CONFIRMED status
6500000000000069 3-D secure version 2, frictionless flow, attempt Payment has CONFIRMED status
6011000000000053 3-D secure version 2, frictionless flow, success Payment has CONFIRMED status
6011000000000251 No 3-D Secure Payment has AUTHORIZED status
6011000000000087 No 3-D Secure Payment has CONFIRMED status
6445222222222275 3-D secure version 2, challenge flow, full authentication Payment has DECLINED status
6445222222221277 No 3-D Secure Payment has DECLINED status

JCB test cards:

Card PAN 3-D Secure result Transaction result
3528000000000015 3-D secure version 2, challenge flow, full authentication Payment has CONFIRMED status
3528000000000023 3-D secure version 2, frictionless flow, success Payment has CONFIRMED status
3528000000000049 3-D secure version 2, frictionless flow, attempt Payment has CONFIRMED status
3528000000000551 No 3-D Secure Payment has AUTHORIZED status
3528000000000007 No 3-D Secure Payment has CONFIRMED status
3535555555555185 3-D secure version 2, challenge flow, full authentication Payment has DECLINED status
3535555555553677 No 3-D Secure Payment has DECLINED status

UnionPay test cards:

Card PAN 3-D Secure result Transaction result
6222020000000085 3-D secure version 2, challenge flow, full authentication Payment has CONFIRMED status
8171000000000000079 3-D secure version 2, frictionless flow, attempt Payment has CONFIRMED status
6200000000000053 3-D secure version 2, frictionless flow, success Payment has CONFIRMED status
6200000000000000 No 3-D Secure Payment has AUTHORIZED status
6222020000000037 No 3-D Secure Payment has CONFIRMED status
8171111111111111195 3-D secure version 2, challenge flow, full authentication Payment has DECLINED status
6200000000001111 No 3-D Secure Payment has DECLINED status

MIR test cards:

Card PAN 3-D Secure result Transaction result
2201380000000785 3-D secure version 2, challenge flow, full authentication Payment has CONFIRMED status
2201380000000819 3-D secure version 2, frictionless flow, attempt Payment has CONFIRMED status
2201000000000000093 3-D secure version 2, frictionless flow, success Payment has CONFIRMED status
2201380000000751 No 3-D Secure Payment has AUTHORIZED status
2201000000000557 No 3-D Secure Payment has CONFIRMED status
2200222222222295 3-D secure version 2, challenge flow, full authentication Payment has DECLINED status
2200222222221677 No 3-D Secure Payment has DECLINED status

Amex test cards:

Card PAN 3-D Secure result Transaction result
370000000000085 3-D secure version 2, challenge flow, full authentication Payment has CONFIRMED status
340000000000033 3-D secure version 2, frictionless flow, success Payment has CONFIRMED status
340000000000009 3-D secure version 2, frictionless flow, attempt Payment has CONFIRMED status
370000000000051 No 3-D Secure Payment has AUTHORIZED status
340000000000017 No 3-D Secure Payment has CONFIRMED status
371111111111155 3-D secure version 2, challenge flow, full authentication Payment has DECLINED status
341111111111137 No 3-D Secure Payment has DECLINED status

Additional card testing information:

If merchant receives non-financial error codes or technical error codes, he needs to contact Unlimint manager.

Merchant uses any cardholder name, expiry date and CVV2/CVC2/CAV2 (Secure code) with these PANs.

For successful Address verification request (AVS code = -1) should be used following values of the parameters:
  • billing_address.country: GB
  • billing_address.city: London
  • billing_address.addr_line_1: 221b, Baker Street
  • billing_address.addr_line_2: empty
  • billing_address.zip: NW1 6XE
    • (see AVS request page).
*For declined Address Verification request should be used any other billing_address field values.

Integration configuration

Credentials and steps to obtain them:

  1. Log in to Unlimint dashboard (Sandbox Dashboard / Production Dashboard).
  2. Click on your profile in the upper right and click on Settings.
  3. Go to Wallet settings in the left menu.
  4. Select the terminal you need to get details from by selecting the ID.
  5. Go to the Credentials section and copy the Terminal Password and Callback Secret.
    6. Be aware of: Credentials for this terminal will be shown ONLY ONCE upon "Show credentials" control activation.

Dashboard configuration:

  1. Log in to dashboard.y.uno.
  2. Click Connections and then select Unlimint.
  3. Click Connect.
  4. Introduce Name, Terminal Password and Callback Secret.
  5. Click Connect

Configuration of webhooks in partner:

  1. Log in to Unlimint dashboard (Sandbox Dashboard / Production Dashboard).
  2. Click on your profile in the upper right and click on Settings.
  3. Go to Wallet settings in the left menu.
  4. Select the terminal you need to get details from by selecting the ID.
  5. Go to the Callbacks section and complete with the URL that corresponds to the environment you are setting up.
  6. Click on Confirm.

Production environment

Specific procedure for a merchant to go live:

After you have done the testing carefully on Sandbox and are ready to go live, you can request production wallets and then go live. No need for a UAT test between your system and Unlimint in production.


Send feedback

Updated 10 days ago