Worldline - Cards

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

Connecting with Yuno

Mandatory fields when integrating via Yuno:

first_name
last_name
country (transaction)
*The provider may request additional fields according to the merchant or to improve the approval rate.

General information

Countries:

globe-flag
Available in 243 countries

Currencies:

Over 150 currencies

Payment methods:

Credit card
Credit card
debit card
Debit card

Minimum amount:

Depends on acquirer, normally 1 USD.

Maximum amount:

Depends on how the risk team categorizes the account.

TRX limit:

No

Support of international BIN:

Your consumers can pay in their own currency, as you can use our platform to process payments in over 150 currencies. You can choose in which currency/currencies you prefer to be settled, depending on the payment product used by your consumer.

Activation of functionality:

The merchant should arrange the functionality and the available currencies with Worldline's team.

TRX without CVV:

Yes. To use this service the merchant should make the necessary arrangements with the Acquirer/Issuer.

Purchase TRX in 1-Step:

Yes

Purchase TRX in 2-Step:

Yes

Support for recurrency:

Available for Colombia, Brasil and Mexico.

Particularities:

To use this service the merchant should make the necessary arrangements with the Acquirer/Issuer to enable this functionality.

Webhooks:

Yes

Captures

Partial capture:

Yes

Multiple captures:

Yes, but there are some acquirers that don't.

Maximum time to capture an authorization:

Depends on acquirer, an average time would be 5 to 7 days.

Captures over the amount of authorization:

No

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refunds:

Yes. Be aware that local card acquiring channels in Argentina, Brazil, Mexico and Colombia impose restrictions on multiple refunds.

Time to request refund:

180 days.

Time to process refund:

Few business days depending on the country and the payment product used to credit the consumer’s account.

Voids

Void support:

Yes

Void to authorization:

Yes

Void to refund:

Yes

Installments

Capability to define the installments when creating the payment:

Yes

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

Yes

Possibility to choose who will be responsible for financing installments:

Yes, depending on installment plans (see below).

Conditions or restrictions:

Installment plans available for Argentina, Brazil, Chile, Colombia, Mexico, Peru and Uruguay.

Deferral date availability:

Yes. Some Issuers lets you apply a deferral date for the first installment; the remaining payments will be applied monthly after the first installment.

Grace period:

No

Minimum number of Installments (#months):

Limit varies from acquirer.

Maximum number of Installments (#months):

Limit varies from acquirer.

Chargebacks

Notifications of chargebacks:

Yes, for the full service model.

Defined period to make a chargeback:

In average 4-6 months.

Endpoint for disputes:

Yes

Maximum time to dispute a chargeback (provide evidence):

10 calendar days.

Security

E3DS v2:

Available for Argentina, Brazil, Chile, Mexico and Peru.

Testing guidelines for sandbox environment

Necessary fields for testing:

Merchant ID, API Key, Secret API Key, Webhook Key ID and Webhook Secret ID.

Test cards:

Test cards in the following links:
For other type of cards go to payment methods, select the type and click on testing.

Integration configuration

Credentials and steps to obtain them:

  1. Log in to worldline's dashboard (testing: sandbox dashboard).
  2. Go to API keys section.
  3. Copy API Key ID and the Secret API Key.

  1. Log in to worldline's dashboard (testing: sandbox dashboard).
  2. Go to Merchant IDs section.
  3. Copy the number under Merchant ID column.

  1. Log in to worldline's dashboard (testing: sandbox dashboard).
  2. Go to Webhooks Keys section.
  3. Copy Key ID and the Secret Key.

Dashboard configuration:

  1. Log in to dashboard.y.uno.
  2. Click Connections and then select Worldline.
  3. Click Connect.
  4. Introduce Name, Merchant ID, API Key, Secret API Key, Webhook Key ID and Webhook Secret ID.
  5. Click Connect

Configuration of webhooks in partner:

  1. Log in to worldline's dashboard (testing: sandbox dashboard).
  2. Go to Webhooks Keys section.
  3. Click on add endpoint and configure the URL.

Production environment

Specific procedure for a merchant to go live:

Tests in STAGING. When ready in STAGING, PRODUCTION is created and Worldline's integration team monitors the first transactions (1 week). After that, the merchant is officially integrated.