The directory lookup returns the available payment methods for the shopper based on the country they are shopping from, the amount and currency and skin code you provided. The returned data is a JSON object containing an array of the payment methods. You can parse the response and provide the list of payment methods to your shopper.
The first part of this payment flow is to make a POST to
All the fields mentioned in the request example (
countryCode, are mandatory.
It is recommended that you provide the
countryCode field, to accurately state the actual location of the payment, so that the correct payment methods for that location are retrieved.
Some payment methods restrict WebView in the app for security reasons. We recommend using the following if you want to display local payment method in your app:
- iOS: SFSafariViewController (https://developer.apple.com/reference/safariservices/sfsafariviewcontroller)
- Android: Chrome Custom Tabs (https://developer.chrome.com/multidevice/android/customtabs)
The directory lookup returns the available payment methods for the shopper based on the country they are shopping from, the amount and currency and skin code you provided. The returned data is a JSON object containing an array with the payment methods. You can parse the response and provide the list of payment methods to your shopper.
To retrieve a list of available local payment methods make a lookup request to the directory endpoint with the fields in the code example. For Adyen to verify the authenticity of the request calculate the signature of the request and include this in the
The example below shows how to make such a request. For additional fields and more details for the payment methods request refer to the API Reference.
A response returns a JSON object containing a list of applicable payment methods. Each payment method has a
brandCode, and optionally, a list of issuers (depending on the payment method). In this case, the
issuerId identifies a specific issuer and can be used to direct a shopper to the related method's webpage.
When parsing this response, you can format and display the methods according to your design if you like.
In case you made a directory lookup request to version 2 (
logos field containing links to normal, small, and tiny images.
If you want, you can skip displaying the payment method selection page with the list of available payment methods returned by the directory lookup. You can route your shopper directly to the payment or order detail entry page.
To use this payment flow:
- Make a payment request call to skipDetails.shtml.
- In the call, include the
Fields for this call vary per payment method, contact Support Team for more information.