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

first_name
last_name
email
payment_description.

General information

Countries:

Argentina

Brazil

Chile

Colombia

Costa Rica

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

BankTransfer

Cash

Colsubsidio

EWallet

Pix

Rappi

Minimum amount:

Can be configured, nevertheless, each APM provider can have a general limit or a limit configured by afilliation.

Maximum amount:

Can be configured, nevertheless, each APM provider can have a general limit or a limit configured by afilliation.

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:

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

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

Support for recurrency:

Webhooks:

Yes

Captures

Only for Cielo (BRL), Prosa (MXN) Procesos and Visanet (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 the Nuvei/Paymentez Team, [email protected], a Development/Sandbox account.
Nuvei/Paymentez 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/Paymentez admin system you will find your transactions, application settings, including application URLs and Application Key, and other configurations.
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/Paymentez'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 - LinkToPay

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