This page presents all information related to the Paymentez (Nuvei company) 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:

No mandatory fields are required. However, the provider may request additional fields according to the merchant or to improve the approval rate.

General information

Countries:

Argentina

Brazil

Chile

Colombia

Costa Rica

Ecuador

El Salvador

Guatemala

Honduras

Mexico

Nicaragua

Panama

Peru

Uruguay

Currencies:

ARS, BRL, CLP, COP, CRC, USD, GTQ, HNL, MXN, NIO, PEN, UYU.

Payment methods:

Credit card

Debit card

Prepaid card

Minimum amount:

Can be configured, must be informed to Nuvei when iniciating the integration process.

Maximum amount:

In order to create a fraud filter a maximum amount can be stablished, must be informed to Nuvei when initiating the integration process.

TRX limit:

Support of international BIN:

Yes

Activation of functionality:

The acceptance of these BINS depends if the card is enabled for international purchases.

TRX without CVV:

Yes (depends on affiliation).

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

Only for Cielo (BRL), Prosa (MXN) Procesos and Visanet (PEN).

Support for recurrency:

Yes

Particularities:

Tokenization

Webhooks:

Yes

Captures

Countries where captures are available:

Captures are available in:

Brazil, with Cielo using BRL.
Mexico, with Prosa using MXN.
Peru, with Procesos and Visanet using PEN.

Partial capture:

Yes

Multiple captures:

Maximum time to capture an authorization:

10 days.

Captures over the amount of authorization:

Yes, only supported for Prosa (MXN).

Maximum amount:

No limit.

Refunds

Refund support:

Yes

Partial refunds:

Supported for Cielo (BRL), Prosa (MXN), Credibanco and Redeban (COP).

Multiple refunds:

Time to request refund:

Colombia: 1 year.
Mexico: 6 months.
Peru: 6 months.
Chile: 6 months.
Argentina: 6 months.
Ecuador: Same day.

Time to process refund:

Depends on the country, the origin of the refund (anullment, adjustment, cancelation), if it is partial or total and the compensation periods.

Voids

Void support:

Only supported for Prosa (MXN).

Void to authorization:

Void to refund:

Installments

Capability to define the installments when creating the payment:

Supported for Colombia, Mexico, Brazil, Peru, Chile and Ecuador.

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

Possibility to choose who will be responsible for financing the installments:

Depends on the affiliation between the bank and the merchant.

Conditions or restrictions:

Deferral date availability:

Supported for Ecuador and Mexico.

Grace period:

Supported for Ecuador (Medianet) and Mexico. Established by the bank and the merchant.

Minimum number of Installments (#months):

1 for Colombia, Peru, Brazil, Chile and Mexico.

Maximum number of Installments (#months):

It is an agreement between the merchant and the acquiring bank, but generally:
Colombia: 36.
Peru: Izipay: 36, Visanet/Niubiz: 12.
Brazil: 12.
Chile: 12.
Mexico: Generally 24, can go up to 36 in certain cases.
Ecuador: 36

Chargebacks

Notifications of chargebacks:

Yes

Defined period to make a chargeback:

180 days since the purchase.

Endpoint for disputes:

No, everything is handled via e-mail: [email protected].

Maximum time to dispute a chargeback (provide evidence):

Colombia: 2 working days.
Peru: 2 working days.
Brazil: 5 working days.
Chile: 5 working days.
Mexico: 3 working days.

Security

E3DS v2:

Yes

Testing guidelines for sandbox environment

Necessary fields for testing:

Application Key and Application Code.

Test cards:

Card	Return Code	Charge succeeds
4111111111111111	valid	Charge succeeds
36417002140808	valid	Charge succeeds
5119159076977991	review	Charge is under Review
370236553676505	review	Charge is under Review
4242424242424242	rejected	Not Authorized
347763907473248	rejected	Not Authorized
4520121813132351	rejected	Rejected by Fraud System
378196561987405	rejected	Rejected by Fraud System
375953548754701	rejected	Card in black list
376337093362277	rejected	Card in black list

Limitations/ Specifications for testing:

For a card not listed, the system will leave the card as valid. Once you add a valid card in the platform you can prove the debit using a specific description as follow:

order.description	Result
Approved transaction	status = success, status_detail = 3
Denied transaction	status = failure, status_detail = 9
Reviewed transaction	status = pending, status_detail = 1
Rejected by fraud system transaction	status = failure, status_detail = 11
Card in black list	status = failure, status_detail = 12

You can use either the test cards or the description to prove, but not both.

In order to do tests in staging environment, the amount of the add credit card is fixed to:
COP: 256
CRC: 256
CLP: 256
USD: 2.56
BRL: 2.56
PEN: 2.56
SGD: 2.56
MXN: 25.6
HNL: 25.6
NIO: 25.6
UYU: 25.6
ARS: 128

Integration configuration

Credentials and steps to obtain them:

To start the integration you will need to request to Nuvei Team [email protected] for a Development/Sandbox account.
Nuvei will create an Application and give you the Application Code. From now this will be the identifier for your Application in the whole integration. In the Nuvei admin system you will see your transactions, application settings (including application URLs and Application Key) and so more.
Configurations have to be done for the application in development environment and production environment, URLs and application key are different for every environment.
Development environment will be always available for tests even after launching your application to production.

Dashboard configuration:

Log in to dashboard.y.uno.
Click Connections and then select Paymentez.
Click Connect.
Introduce Name, Country, Application Key and Application Code.
Click Connect.

Configuration of webhooks in partner:

Provide URL to Nuvei's staff.

Production environment

Specific procedure for a merchant to go live:

Yes, there is a flow, channels, SLA, Data Entry required to make the integration.

Paymentez - Cards

General Information

Captures

Refunds

Voids

Installments

Chargebacks

Security

Testing Guidelines

Integration Configuration

Production Environment

Connecting with Yuno

General information

Captures

Refunds

Voids

Installments

Chargebacks

Security

Testing guidelines for sandbox environment

Integration configuration

Production environment

Send feedback