{"title":"PaySafeCard for API only","category":"default","creationDate":1776961628,"content":"

You can add PaySafeCard to your existing integration. The following instructions show only what you must add to your integration specifically for PaySafeCard.<\/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 PaySafeCard in your Customer Area<\/a>. <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

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

    Build your payment form<\/h2>\n

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

    \n

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

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

    When you make the \/paymentMethods<\/a> to get available payment methods<\/a>, specify the following so that PaySafeCard 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>\nAE<\/strong>, AT<\/strong>, AU<\/strong>, BE<\/strong>, BR<\/strong>, CA<\/strong>, HR<\/strong>, CY<\/strong>, CZ<\/strong>, DK<\/strong>, FI<\/strong>, FR<\/strong>, DE<\/strong>, GE<\/strong>, GB<\/strong>, GIB<\/strong>, HU<\/strong>, IS<\/strong>, IT<\/strong>, IE<\/strong>, LV<\/strong>, LT<\/strong>, LU<\/strong>, LI<\/strong>, MT<\/strong>, MX<\/strong>, MD<\/strong>, ME<\/strong>, NL<\/strong>, NZ<\/strong>, NO<\/strong>, PY<\/strong>, PE<\/strong>, PL<\/strong>, PT<\/strong>, RO<\/strong>, SRB<\/strong>, SK<\/strong>, SI<\/strong>, ES<\/strong>, SE<\/strong>, CH<\/strong>, TR<\/strong>, UY<\/strong>, US<\/strong><\/td>\n<\/tr>\n
    amount.currency<\/a><\/td>\nAED<\/strong>, AUD<\/strong>, BRL<\/strong>, CAD<\/strong>, CHF<\/strong>, CZK<\/strong>, DKK<\/strong>, EUR<\/strong>, GBP<\/strong>, HUF<\/strong>, ISK<\/strong>, MXN<\/strong>, NOK<\/strong>, NZD<\/strong>, PEN<\/strong>, PLN<\/strong>, RON<\/strong>, RSD<\/strong>, SEK<\/strong>, TRY<\/strong>, USD<\/strong>, UYU<\/strong>, GEL<\/strong>, GIP<\/strong>, MDL<\/strong>, PYG<\/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 parameters:<\/p>\n\n\n\n\n\n
    Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    shopperReference<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nYour reference to uniquely identify this shopper, for example user ID or account ID.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n <\/code-sample>\n<\/div>\n

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

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

    Handle the redirect<\/h2>\n
      \n
    1. \n

      To complete the payment, redirect the shopper to the action.url<\/code> returned in the \/payments<\/a> response, taking into account the following recommendations:<\/p>\n