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

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

If an instruction on this page corresponds with a step in the main integration guide, it includes a link to that 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> or sdk<\/strong>.<\/td>\n		<\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\n Before you begin, add TWINT in your Customer Area<\/a>. <\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

How it works<\/h2>\n
    \n
  1. The shopper selects TWINT as the payment method.<\/li>\n
  2. The shopper enters their details in the payment form that you build<\/a>.<\/li>\n
  3. The shopper is redirected to a TWINT hosted payment page<\/li>\n
  4. The shopper authorizes the payment in the TWINT app.<\/li>\n<\/ol>\n

    Build your payment form<\/h2>\n

    Include TWINT 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 TWINT<\/a> to use in your form.<\/p>\n<\/div>\n

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

    When you make the \/paymentMethods<\/a> to get available payment methods<\/a>, specify the following so that TWINT 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>\nCH<\/strong><\/strong><\/span><\/td>\n<\/tr>\n
    amount.currency<\/a><\/td>\nCHF<\/strong><\/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

    You do not need to add any additional parameters when you make a payment<\/a>.<\/p>\n

    Capture the payment<\/h2>\n

    By default, TWINT payments are captured automatically. This means that the Capture Delay<\/strong> setting in your Customer Area<\/a> is set to Immediate<\/strong> or 1\u20137 days<\/strong>.<\/p>\n

    In case Capture Delay<\/strong> is set to Manual<\/strong>, then you need to manually capture the payment<\/a>. The authorization for TWINT payments expires after 7 days, so make sure you capture the payment before then.<\/p>\n

    Partial capture<\/h3>\n

    TWINT supports partial capture, but not multiple partial captures. To partially capture<\/a> a TWINT payment, specify in your\u00a0 \/payments\/{paymentPspReference}\/captures<\/a> request:<\/p>\n