Pix via Adyen

​

Supported workflows

​

Before you begin

1. Set up an Adyen integration in your workspace. Follow the Adyen integration setup guide if you don’t have one yet.
2. Ask Adyen to enable Pix on your Adyen merchant account.
3. In the Payrails Portal, go to Settings → Integrations, open your Adyen integration, select Pix under Payment methods, and save.
4. Add Pix as a payment option in your workflow.

​

Request fields for Adyen

​

Authorize a Pix payment

{
  "amount": {
    "value": "150.00",
    "currency": "BRL"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "pix",
      "amount": {
        "value": "150.00",
        "currency": "BRL"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Ana",
      "lastName": "Souza",
      "email": "ana.souza@example.com",
      "identityCardNumber": "12345678909",
      "country": {
        "code": "BR"
      }
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Adyen handles Pix

• Adyen returns the Pix QR code, and Payrails turns it into a redirect to a Payrails-hosted page that shows the code to the customer.
• The payment stays pending until the customer pays. Payrails completes it when Adyen sends the authorization notification.
• Adyen captures Pix payments automatically. When Adyen confirms the authorization, Payrails also records the capture, so the payment completes in one step.
• Adyen doesn’t support canceling a Pix payment. Refund a completed payment instead.