Sign in

v1

latestOpenAPI 3.1.02026-07-241080412.6 KB

Add Adyen payment details

Use this method to add Adyen payment details (for example a card with 3D Secure support, Apple Pay or Google Pay), so that new payment details can be used for recurring payments. Example use case: a customer updates a card or wants to switch payment method to a card.

Adding payment details may not be finished after calling this endpoint. If payment details were successfully added to Cleeng, you will receive the paymentDetails object. If there is an additional action needed, you will receive an action object.

post/connectors/adyen/payment-details

Request body

paymentMethodIdinteger required

ID of publisher payment method with: Adyen paymentGateway, and methodName that customer selected.

returnUrlstring required

The URL to return to in case of a redirection.

customerIPstring

IP address of customer current location. If not given, the IP of the request will be used. Please note this IP address is also used to prevent fraud. (Make sure you send the end-user IP, and not that of any possible middleware).

browserInfoobject

Required for 3D Secure. The customer browser information. The state.data.browserInfo object from the Adyen's Drop-in onSubmit event.

originstring

Required for 3D Secure. Set this parameter to the origin URL of the page that you are loading the 3D Secure Component from.

attemptAuthenticationstring

Accepted only in the sandbox environment. It helps to control when 3DSecure should be triggered. Accepted values: always, never, preferNo. Default: preferNo

enable3DSRedirectFlowboolean

Accepted only in the sandbox environment. Default: false. Set to true to force 3DS redirect flow.

Response

200

Example response

{
  "responseData": {
    "action": {
      "paymentMethodType": "scheme",
      "url": "https://test.adyen.com/hpp/3d/validate.shtml",
      "data": {
        "MD": "OEVudmZVMUlkWjd0MDNwUWs2bmhSdz09...",
        "PaReq": "eNpVUttygjAQ/RXbDyAXBYRZ00HpTH3wUosPfe...",
        "TermUrl": "https://example.com/checkout?shopperOrder=12xy..."
      },
      "method": "POST",
      "type": "redirect"
    }
  }
}