iOS Component

To install iOS Drop-in using Swift Package Manager, follow the Apple guide and specify:

• The repository URL as https://github.com/Adyen/adyen-ios
• The version to be at least v5.42.0
• Include AdyenCashAppPay

To install iOS Drop-in from CocoaPods:

1. Add pod 'Adyen/CashAppPay' to your Podfile.
2. Run pod install.

// Create a `CashAppPayConfiguration` instance with the redirect URL for your your app.
let configuration = CashAppPayConfiguration(redirectURL: URL(string: "yourAppURLOrScheme"))
// Create a `CashAppPayPaymentMethod` instance from your payment methods list.
let paymentMethod = paymentMethods.paymentMethod(ofType: CashAppPayPaymentMethod.self)
//Create the the `CashAppPayComponent` with the `paymentMethod` and the `configuration`.
let component = CashAppPayComponent(paymentMethod: paymentMethod, context: adyenContext, configuration: configuration)

Set your AdyenSession instance as the delegate to let it handle the flow.

component.delegate = self.adyenSession

Present your component's view.

navigationController.present(component.viewController)

// Create a `CashAppPayConfiguration` instance with the redirect URL for your your app.
let configuration = CashAppPayConfiguration(redirectURL: URL(string: "yourAppURLOrScheme"))
// Create a `CashAppPayPaymentMethod` instance from your payment methods list.
let paymentMethod = paymentMethods.paymentMethod(ofType: CashAppPayPaymentMethod.self)
//Create the the `CashAppPayComponent` with the `paymentMethod` and the `configuration`.
let component = CashAppPayComponent(paymentMethod: paymentMethod, context: adyenContext, configuration: configuration)

The shopper clicks the Cash App Pay button to authorize the payment in their Cash App Pay app. When the shopper returns to your app, the Component invokes the didSubmit method. Get the contents of data.paymentMethod and pass this to your server. Dismiss the Component immediately, or wait until you have submitted the details to your server.

func didSubmit(_ data: PaymentComponentData, from component: PaymentComponent)

In case an error occurs on the app, the Component invokes the didFail method from the PaymentComponentDelegate. Dismiss the Component's view controller and show an error message.

func didFail(with error: Error, from component: PaymentComponent)

Create a token

Include the storedPaymentMethodMode parameter in your /sessions request. Possible values:

The Cash App SDK requires you to specify whether to create a recurring request. If you set storedPaymentMethodMode to enabled or disabled, you must also specify the following in your configuration:

• storedPaymentMethod: To store the payment method. This property is ignored if showsStorePaymentMethodField is true.

If you or the shopper chooses to store payment details, your instance of AdyenSession creates a token when the shopper pays.

Make a payment with a token

When the shopper pays, your instance of AdyenSession includes the shopper's stored Cash App Pay details. You can also use tokens to make shopper-not-present payments for subscriptions or contracts.

Create a token

If you are using the Advanced Flow with the /paymentMethods endpoint, set the showsStorePaymentMethodField parameter in your component configuration:

-To show the toggle to let the shopper choose whether to save their payment details, set showsStorePaymentMethodField to true.

• To not show the toggle and instead store the shopper's payment details automatically, set showsStorePaymentMethodField to false when adding the Cash App Pay Component, and set storePaymentMethod to true.

let configuration = CashAppPayComponent.Configuration(showsStorePaymentMethodField: true)
let component =  CashAppPayComponent(paymentMethod: paymentMethod,
                               apiContext: apiContext,
                               configuration: configuration)
component.delegate = self
self.cashAppPayComponent = component
present(component.viewController, animated: true)

If the payment is made with stored details, the didSubmit method from the Component will include data.storePaymentMethod. Pass this to your server.

To create a token, include in your /payments request:

• storePaymentMethod: The data.storePaymentMethod from your client app.
• shopperReference: Your unique identifier for the shopper.

Make a payment with a token

When the shopper proceeds to pay, the Component invokes the didSubmit method containing the data.paymentMethod from the PaymentComponentDelegate.

1. Pass the data.paymentMethod to your server.
2. From your server, make a /payments request, specifying:
   • paymentMethod: The data.paymentMethod from the didSubmit event from your client app.

You can also use tokens to make shopper-not-present payments for subscriptions or contracts.