Direct integration

Yuno makes it easy to integrate Apple Pay into your payment system. This guide will help you set up connections, configure routing, and start processing payments securely with Yuno’s Direct Integration.

Step 1: Add the connection

First, you have to add the Apple Pay connection to the Yuno Dashboard by following these steps:

1. Log in to your Yuno Dashboard.
2. Navigate to the Connections section.
3. Locate and select the Apple Pay option and click Connect.
4. Provide a Name for the connection, select Apple Pay as Payment method, and provide the information you acquired when following the Prerequisites process.
5. Click Add. Apple Pay will be added to your connections.

Step 2: Add a route for Apple Pay

Set up a new route to control how payments are processed through Apple Pay. Follow the steps below:

1. In the Yuno Dashboard, navigate to the Routing section.
2. Find the Apple Pay connection. If you have not created a route for Apple Pay yet, it will be on the Not published tab.
3. Set up a new route by pressing Setup on your Apple Pay module and then clicking on Create new route.
4. Add conditions to specify when payments should be routed through Apple Pay.
5. Add Apple Pay as the payment processor for this route to ensure that payments meeting the defined conditions are processed through Apple Pay.
6. Save and publish the route once all configurations are defined.

The following image displays a simple route through which Apple Pay processes all payments.

7. Once that is done, you will need to set the route for the Card payment method indicating with which provider you want to process payments with.

Step 3: Update the Checkout Builder

To make Apple Pay available to your end users, you have to enable it on the Checkout Builder by following these steps:

1. In the Yuno Dashboard, navigate to the Checkout Builder section.
2. Select Set condition.
3. Under Payment methods, enable Apple Pay.
4. Click Publish to make Apple Pay available as a payment option for all transactions that meet the defined routing criteria.

Step 4: Creating payments with Direct Integration

Follow the steps below to process payments using the Direct Integration method. For a detailed walkthrough of each step, refer to the full guide on Creating Payments:

1. Create a Customer: Use the Create Customer endpoint to register the customer's information. (Optional)

2. Create the Payment: Use the Create Payment endpoint to create a payment sending the cryptogram returned by Apple Pay SDK. If you do not have integrated Apple's SDK, we recommend using our SDKs so you don't have to worry about the integration.

3. Retrieve Payment Details: To check the payment status, you can analyze the status and sub_status in the response from the Create Payment endpoint or use the Webhooks. Refer to the Payment Status page to see all possible statuses.