Scalapay

​

How a Scalapay payment works

1. The customer selects Scalapay at checkout.
2. Payrails returns a redirect URL from Adyen, and the customer goes to Scalapay.
3. The customer approves the instalment plan on the Scalapay page.
4. Scalapay sends the customer back to your returnInfo URL.
5. Payrails receives the final result from Adyen and updates the payment.

​

Supported currencies and countries

​

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 Scalapay on your Adyen merchant account.
3. In the Payrails Portal, go to Settings → Integrations, open your Adyen integration, select Scalapay under Payment methods, and save.
4. Add Scalapay as a payment option in your workflow.

​

Request fields for Adyen

​

Authorize a Scalapay payment

{
  "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"
  }
}

​

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.