Payment-method icon

Walley iOS Component

Add Walley to your existing iOS Components integration.

This page explains how to add Walley to your existing iOS Components integration.

Requirements

Requirement Description
Integration type Make sure that you have built your Components integration.

Walley for iOS works with all versions of Components.

Setup steps Before you begin, contact our Support Team to add Walley in your test Customer Area.

API reference

You must include the following fields when making a /sessions request:

Parameter name Required Description
telephoneNumber -white_check_mark- The shopper's telephone number.
You must collect a working mobile phone number (including country code) from the customer. Incorrect or missing numbers will fail Walley's validation.
shopperEmail -white_check_mark- The shopper's email address.
company.name -white_check_mark- The name of the company making the payment. This will be prefilled and presented to the shopper on Walley's payment form. Only required for walley_b2b payments.
company.registrationNumber Only relevant to business-to-business payments. The registration number of the company making the payment.
lineItems.id -white_check_mark- The ID of the line item.
lineItems.description -white_check_mark- A description of the line item. Maximum length: 50 characters.
lineItems.amountExcludingTax -white_check_mark- The item amount excluding the tax, in minor units.
lineItems.taxAmount -white_check_mark- The tax amount, in minor units.
lineItems.taxPercentage -white_check_mark- The tax percentage, in minor units.
lineItems.quantity -white_check_mark- The number of 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 Walley Component:

Component configuration
Expand view
Copy link to code block
Copy code
Copy code
let paymentMethods = session.sessionContext.paymentMethods
// Check that the payment method is supported before showing the Component.
guard let paymentMethod = paymentMethods.paymentMethod(ofType: .other("walley")) 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:

Component configuration
Expand view
Copy link to code block
Copy code
Copy code
// Check that the payment method is supported before showing the Component.
guard let paymentMethod = paymentMethods.paymentMethod(ofType: WalleyPaymentMethod.self) else { return }
let style = FormComponentStyle()
let component = WalleyComponent(paymentMethod: paymentMethod,
apiContext: context,
style: style)
present(component)

There are no configuration steps specific to Walley required for Components.

Test and go live

You can perform the test scenarios described on Walley's technical documentation using Adyen's /payments endpoint. Consider the following:

  • Include the CivRegNo as the socialSecurityNumber.
  • When testing a Walley B2B transaction, provide the company information as shown in the following example:
    Copy code
    "company": {
    "name": "Adyen N.V.",
    "registrationNumber": "5562000116"
    }

Check the status of Walley verification payments in your Customer Area > Transactions > Payments.

See also