This page explains how to add Scalapay to your existing Android Components integration.
Choose the server-side flow that your integration uses:
Requirements
Requirement | Description |
---|---|
Integration type | Make sure that you have built a Sessions flow Android Components integration. The minimum required version is 5.0.0. |
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.
Create a payment session
This step corresponds to Create a payment session in the Components integration guide.
You do not need to include any additional parameters for Scalapay in the API request.
Set up Components
This section corresponds to Set up Components in the Components integration guide.
Import the library
This step corresponds to the Import the library step of the Components integration guide.
During this step of integrating, use the following code snippets:
With Jetpack Compose
implementation "com.adyen.checkout:instant:YOUR_VERSION" implementation "com.adyen.checkout:components-compose:YOUR_VERSION"
Without Jetpack Compose
implementation "com.adyen.checkout:instant:YOUR_VERSION"
Configure the Component
This step corresponds to Configure components of the Components integration guide.
No specific configuration is required for Scalapay.
Create the checkout session
This step corresponds to the create a payment session step in the main integration guide.
Launch and show the Component
This corresponds to the Launch and show the Component step in the main integration guide.
During this step of integrating, use the following code snippets:
With Jetpack Compose
Component import com.adyen.checkout.components.compose.get // Get the payment method. val paymentMethod = checkoutSession.getPaymentMethod(PaymentMethodTypes.SCALAPAY) @Composable private fun ComposableInstantComponent() { // Keep a reference to this Component in case you need to access it later. val instantPaymentComponent = InstantPaymentComponent.PROVIDER.get( checkoutSession = checkoutSession, paymentMethod = paymentMethod, configuration = configuration, componentCallback = callback, // This key is required to ensure a new Component gets created for each different screen or payment session. // Generate a new value for this key every time you need to reset the Component. key = "YOUR_UNIQUE_KEY_FOR_THIS_COMPONENT", ) // This is your composable, a wrapper around our xml view. AdyenComponent( component = instantPaymentComponent, modifier = YOUR_MODIFIER, )
Without Jetpack Compose
<com.adyen.checkout.ui.core.AdyenComponentView android:id="@+id/YOUR_COMPONENT_VIEW_ID" .../> // Get the payment method. val paymentMethod = checkoutSession.getPaymentMethod(PaymentMethodTypes.SCALAPAY) val instantPaymentComponent = InstantPaymentComponent.PROVIDER.get( activity, // Your activity or fragment. checkoutSession, paymentMethod, cardConfiguration, componentCallback, ) binding.componentView.attach(instantPaymentComponent, viewLifecycleOwner)
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.