This page explains how to add Scalapay to your existing Components integration.
Requirements
Select the server-side flow that your integration uses:
Requirement | Description |
---|---|
Integration type | Make sure that you have built a Sessions flow Components integration. |
Setup steps | Before you begin, add Scalapay in your Customer Area. |
Activating Scalapay defaults the pricing to our standard pricing. Adyen offers Enterprise pricing for merchants with sufficient volume. Before activating Scalapay, contact your account manager to verify if you are eligible.
API reference
Select which endpoint you are using:
This is the default with Components v5.0.0 or later.
Parameter name | Required | Description |
---|---|---|
countryCode | The shopper's two-letter country code: IT, FR, PT or ES. | |
shopperName | The shopper's firstName and lastName . |
|
billingAddress | The shopper's billing address. | |
deliveryAddress | The delivery address for the goods purchased. | |
lineItems | Price and product information about the purchased items. |
Component configuration
v5.0.0 or later
If your integration uses iOS Components v5.0.0 or later, configure and create an instance of the Scalapay Component:
let paymentMethods = session.sessionContext.paymentMethods // Check that the payment method is supported before showing the Component. guard let paymentMethod = paymentMethods.paymentMethod(ofType: .other("scalapay_3x")) else { return } let component = InstantPaymentComponent(paymentMethod: paymentMethod, context: context, order: nil) self.currentComponent = component // Set the session as the delegate. component.delegate = session component.initiatePayment()
v4.x.x
If your integration uses an earlier version of iOS Components:
// Check that the payment method is supported before showing the Component. guard let paymentMethod = paymentMethods.paymentMethod(ofType: ScalapayPaymentMethod.self) else { return } let style = FormComponentStyle() let component = ScalapayComponent(paymentMethod: paymentMethod, apiContext: context, style: style) present(component)
There are no configuration steps specific to Scalapay required for Components.
Test and go live
Use the test cards for the test scenarios that are specified on the Scalapay website.
Check the status of Scalapay test payments in your Customer Area > Transactions > Payments.
Before you can accept live Scalapay payments, submit a request for Scalapay in your live Customer Area.