Adyen - PIX

This page presents all information related to the Adyen connection using PIX 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
document_number

General information

Countries:

brazil-flag
Brazil

Currencies:

BRL

Minimum amount:

R$ 0,01

Maximum amount:

There is no limit for the day (between 6am and 8pm or 10pm), for the night (between 8pm or 10pm and 6am) the limit is R$ 1,000. Each institution can establish its own Pix limit as a security and anti-fraud mechanism. The only rule is that this limit cannot be lower than the TED limit or a debit card transaction limit, depending on each case.

TRX limit:

No

Purchase TRX:

Shoppers can pay with Pix when shopping online. The money is sent directly from the shopper account to Adyen's account, and then transferred once a day to the merchant's bank account.

Support for recurrency:

No

Webhooks:

Yes

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refunds:

Yes

Time to request refund:

Refunds and partial refunds are only possible within 90 days after the payment.

Time to process refund:

Standard is 2 days, depends on issuer connection.

Voids

Void support:

No

Installments

Capability to define the installments when creating the payment:

No

Chargebacks

Notifications of chargebacks:

No

Testing guidelines for sandbox environment

Necessary fields for testing:

Account Code, API key.

Limitations/Specifications for testing:

Pix is an asynchronous payment method. In the test environment, you can simulate a Pix payment by promoting the pending payment to a sale.
  1. Log in to your test Customer Area.
  2. Go to Transactions > Offers.
  3. Select the PSP reference of the pending Pix payment.
  4. Select the Promote this offer to a sale button.
Pix payments that have been paid (including test offers that you manually promoted to sale) are under Transactions > Payments.

Before you can accept live Pix payments, you need to submit a request for Pix in your live Customer Area.

Integration configuration

Credentials and steps to obtain them:

Generate an API key
To generate an API key, you must have one of the following user roles: Merchant admin role, Manage API credentials.
  1. Log in to your Customer Area.
  2. Go to Developers > API credentials, and select the API credential username for your integration, for example ws@Company.[YourCompanyAccount].
  3. Under Server settings > Authentication select the API key tab.
  4. Select Generate API key.
  5. Select the copy icon and store your API key securely in your system.
  6. Select Save changes.
*When you switch to your live environment, you must generate a new API key in your live Customer Area.

Dashboard configuration:

  1. Log in to dashboard.y.uno.
  2. Click Connections and then select Adyen.
  3. Click Connect.
  4. Introduce Name, Account Code and API Key.
  5. Click Connect.

Configuration of webhooks in partner:

  1. Log in to Adyen dashboard.
  2. Select the merchant account you want to enable notifications.
  3. Navigate to Developers and then Webhooks.
  4. Navigate to Recommended webhooks and Standard notification.
  5. Select Add and enable the notification.
  6. Select Edit and type the following values for each field:
    1. URL for test mode: https://sandbox.y.uno/adyen-webhook/v1/confirmations
    2. URL for live mode: https://prod.y.uno/adyen-webhook/v1/confirmations
    3. Method: JSON
    4. Encryption Protocol: TLSv1.2
  7. Select Apply and Save changes.

Production environment

Specific procedure for a merchant to go live:

The setup from your test Customer Area is not copied over to your live Customer Area, so you need to configure live settings for:
  • Account
  • Finance
  • Risk and compliance
  • API communication
  • Notification webhooks
After you have configured your live Customer Area, test your integration by making real payments.