Scalapay via Adyen

Accept Scalapay payments with Adyen as the payment service provider (PSP).

Supported workflows

Before you begin

Complete these steps before you send your first Scalapay payment through Adyen:

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

Request fields for Adyen

Send these fields in the authorize request, in addition to the standard authorize fields. Required fields must be present for the payment to succeed. Payrails sends Optional fields to the PSP when you include them.

Field	Status	Description
`amount.currency`	Required	Must be `EUR`. Payrails rejects other currencies.
`meta.customer.country.code`	Required	Must be `IT`, `FR`, `PT` or `ES`. Payrails rejects a missing or other country.
`meta.customer.email`	Required	Sent to Adyen as the shopper email.
`meta.customer.name`, `meta.customer.lastName`	Required	Sent to Adyen as the shopper name. Payrails needs both.
`meta.order.billingAddress`	Optional	Sent to Adyen as the billing address.
`meta.order.deliveryAddress`	Optional	Sent to Adyen as the delivery address.
`meta.order.lines`	Optional	Sent to Adyen as line items.
`meta.order.softDescriptor`	Optional	Shown on the customer’s statement.

Authorize a Scalapay payment

Call authorize a payment with scalapay as the paymentMethodCode. The response includes the redirect to Scalapay.

Authorize request

{
  "amount": {
    "value": "120.00",
    "currency": "EUR"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "scalapay",
      "amount": {
        "value": "120.00",
        "currency": "EUR"
      }
    }
  ],
  "meta": {
    "customer": {
      "name": "Giulia",
      "lastName": "Romano",
      "email": "giulia.romano@example.com",
      "country": {
        "code": "IT"
      }
    },
    "order": {
      "softDescriptor": "Example Store"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

After the customer approves the plan, Scalapay returns them to your success or error URL. Confirm the result through webhook notifications or the execution status before you fulfill the order.

How Adyen handles Scalapay

Adyen confirms the authorization by webhook. Scalapay isn’t captured automatically: with delayed capture, the payment stays authorized until you capture it or cancel it.
Partial captures, and several captures against one authorization, work only when Adyen enables multiple partial captures on your merchant account.
When you refund a payment you captured separately, Payrails tells Adyen which capture the refund belongs to.
Scalapay supports customer-initiated payments only. Payrails rejects the CardOnFile, MOTO, Subscription and Unscheduled processing types for Scalapay, and doesn’t save the instrument even when you set storeInstrument.

Getting Started

Payment Orchestration

Token Vault

Analytics & Reporting

Fraud Management

Chargebacks

Monitoring

Resources

Use Cases

Supported workflows

Before you begin

Request fields for Adyen

Authorize a Scalapay payment

How Adyen handles Scalapay

​Supported workflows

​Before you begin

​Request fields for Adyen

​Authorize a Scalapay payment

​How Adyen handles Scalapay

Supported workflows

Before you begin

Request fields for Adyen

Authorize a Scalapay payment

How Adyen handles Scalapay