{"title":"Alipay+ for API only","category":"default","creationDate":1784631444,"content":"

You can add Alipay+ to your existing integration. The following instructions show only what you must add to your integration specifically for Alipay+.<\/p>\n

If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.<\/p>\n

Requirements<\/h2>\n\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nMake sure that you have an existing API-only integration<\/a>.<\/td>\n <\/td>\n<\/tr>\n
Redirect handling<\/strong><\/td>\nMake sure that your existing integration is set up to handle the redirect<\/a>.
action.type<\/code>: redirect<\/strong>.<\/td>\n		<\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\n Before you begin, add Alipay+ in your Customer Area<\/a>. <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n
    \n
  1. The shopper selects Alipay+ as payment method.<\/li>\n
  2. The shopper then selects their preferred wallet that is included with Alipay+.<\/li>\n
  3. The shopper enters their details in the payment form that you build<\/a>, if applicable.<\/li>\n
  4. When you make the payment request, you include additional information about the items that the shopper intends to purchase<\/a>, if applicable.<\/li>\n
  5. Your existing integration setup will handle the redirect<\/a>.<\/li>\n<\/ol>\n

    Build your payment form<\/h2>\n

    Include Alipay+ in the list of available payment methods<\/a>. You do not need to collect any additional information from the shopper in your payment form.<\/p>\n

    \n

    You can download the logo for Alipay+<\/a> to use in your form.<\/p>\n<\/div>\n

    Get Alipay+ as an available payment method<\/h2>\n

    When you make the \/paymentMethods<\/a> to get available payment methods<\/a>, specify the following so that Alipay+ is included in the response.<\/p>\n\n\n\n\n\n\n
    Parameter<\/th>\nValues<\/th>\n<\/tr>\n<\/thead>\n
    countryCode<\/a><\/td>\nAT<\/strong>, AU<\/strong>, BE<\/strong>, CA<\/strong>, CH<\/strong>, CN<\/strong>, CY<\/strong>, CZ<\/strong>, DE<\/strong>, DK<\/strong>, EE<\/strong>, ES<\/strong>, FI<\/strong>, FR<\/strong>, GB<\/strong>, GR<\/strong>, HK<\/strong>, HU<\/strong>, IE<\/strong>, IS<\/strong>, IT<\/strong>, JP<\/strong>, LI<\/strong>, LT<\/strong>, LU<\/strong>, LV<\/strong>, MT<\/strong>, MY<\/strong>, NL<\/strong>, NO<\/strong>, NZ<\/strong>, PL<\/strong>, PT<\/strong>, RO<\/strong>, SE<\/strong>, SG<\/strong>, SI<\/strong>, SK<\/strong>, US<\/strong><\/td>\n<\/tr>\n
    amount.currency<\/a><\/td>\nAED<\/strong>, AUD<\/strong>, CAD<\/strong>, CHF<\/strong>, CNY<\/strong>, CZK<\/strong>, DKK<\/strong>, EUR<\/strong>, GBP<\/strong>, HKD<\/strong>, JPY<\/strong>, MYR<\/strong>, NOK<\/strong>, NZD<\/strong>, SEK<\/strong>, SGD<\/strong>, USD<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n <\/code-sample>\n<\/div>\n
    \n <\/code-sample>\n<\/div>\n

    Add additional parameters to your \/payments request<\/h2>\n

    When you make a payment<\/a>, add the following additional parameters:<\/p>\n\n\n\n\n\n\n
    Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    channel<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nSet to the applicable channel: Web<\/strong>, iOS<\/strong>, or Android<\/strong><\/td>\n<\/tr>\n
    browserInfo<\/a><\/td>\n<\/td>\nInformation about the shopper's browser. Required when channel<\/code> is Web<\/strong>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n <\/code-sample>\n<\/div>\n

    The response includes the action.type<\/code>: redirect<\/strong>.<\/p>\n

    \n <\/code-sample>\n<\/div>\n

    The shopper is redirected to the checkout page of Alipay+ where they select their wallet (for example GCash, KakaoPay, TrueMoney, DANA, AlipayHK, or one of the other available wallets).<\/p>\n

    Handle the redirect<\/h2>\n

    After the shopper authenticates in their wallet they are redirected back to returnUrl<\/code>.<\/p>\n

    Adyen collects the redirect result value from returnUrl<\/code>, for example:<\/p>\n

    \n <\/code-sample>\n<\/div>\n

    Adyen then sends the value of redirectResult<\/code> in the \/payments\/details<\/a> request:<\/p>\n

    \n <\/code-sample>\n<\/div>\n