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

You can add PayPo to your existing integration. The following instructions show only what you must add to your integration specifically for PayPo.<\/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
Action handling<\/strong><\/td>\nMake sure that your existing integration is set up to handle the additional action<\/a>.
action.type<\/code>: redirect<\/strong><\/span>.<\/td>\n		<\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\n Before you begin, add PayPo in your Customer Area<\/a>. <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n
    \n
  1. The shopper selects PayPo 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
  5. You capture the payment<\/a>.<\/li>\n<\/ol>\n

    Build your payment form<\/h2>\n

    Include PayPo in the list of available payment methods<\/a>.<\/p>\n

    \n

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

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

    When you make the \/paymentMethods<\/a> to get available payment methods<\/a>, specify the following so that PayPo 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>\nPL<\/strong><\/span><\/td>\n<\/tr>\n
    amount.currency<\/a><\/td>\nPLN<\/strong><\/span><\/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\n\n\n\n
    Parameter<\/th>\nRequired<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
    paymentMethod.type<\/code><\/td>\n\"-white_check_mark-\"<\/td>\npaypo<\/strong><\/td>\n<\/tr>\n
    shopperName<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nThe shopper's email address.<\/td>\n<\/tr>\n
    shopperEmail<\/a><\/td>\n\"-white_check_mark-\"<\/td>\nThe shopper's firstName<\/code> and lastName<\/code>.<\/td>\n<\/tr>\n
    billingAddress<\/a><\/td>\n<\/td>\nThe shopper's billing address.<\/td>\n<\/tr>\n
    deliveryAddress<\/a><\/td>\n<\/td>\nThe delivery address for the goods purchased.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n <\/code-sample>\n<\/div>\n

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

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

    Capture the payment<\/h2>\n

    When a payment is made, but not yet authorized, the offer will be available for up to 72 hours. Therefore, the shopper can use the link to the payment for up to 72 hours.<\/p>\n

    When the payment is accepted by the shopper, its status will change to Authorised<\/strong>. The shopper has 30 days to pay according to the terms of PayPo. This is different to some other payment methods where the payment term usually starts after the capture, not after the authorization.<\/p>\n

    After the payment is authorized, you also have to capture the payment.<\/p>\n