iOS Drop-in

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.

To add Cash App Pay to your Drop-in integration, set the cashAppPay property of Drop-in's configuration instance.

dropInConfiguration.cashAppPay = CashAppPayConfiguration(redirectURL: URL(string: "yourAppURLOrScheme"))

Set your AdyenSession instance as Drop-in's delegate to let it handle the flow.

dropIn.delegate = self.session

Present the Drop-in's view (modally, in a navigation stack, and so on).

navigationController.present(dropIn.viewController)

To add Cash App Pay to your Drop-in integration, set the cashAppPay property of Drop-in's configuration instance.

dropInConfiguration.cashAppPay = CashAppPayConfiguration(redirectURL: URL(string: "yourAppURLOrScheme"))

Present the Drop-in view.

navigationController.present(dropIn.viewController)

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, Drop-in invokes the didSubmit method. Get the contents of data.paymentMethod and pass this to your server.

func didSubmit(_ data: PaymentComponentData, for paymentMethod: PaymentMethod, from component: DropInComponent)

If an error occurs on the app, Drop-in invokes the didFail method. Dismiss Drop-in's view controller and show an error message.

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

If the shopper decides not to continue with Cash App Pay, Drop-in invokes the didCancel method. You can use didCancel to track the state of the payment.

func didCancel(component: PaymentComponent, from dropInComponent: DropInComponent)

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 use the advanced flow with the /paymentMethods endpoint, set the showsStorePaymentMethodField parameter in your configuration:

• To show a toggle that lets 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 without asking, set showsStorePaymentMethodField to false when adding Cash App Pay, and set storePaymentMethod to true.

If the payment is made with stored details, the didSubmit method 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, Drop-in 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.