TWINT

​

How a TWINT payment works

1. The customer selects TWINT at checkout.
2. Payrails creates the payment at Checkout.com and returns a redirect URL.
3. The customer follows the redirect and confirms the payment in the TWINT app. The customer needs the TWINT mobile app to complete the payment.
4. The customer returns to your returnInfo URL.
5. Payrails receives the final result from Checkout.com and updates the payment.

​

Supported currencies and countries

​

Supported workflows

​

Before you begin

1. Set up a Checkout.com integration in your workspace. Follow the Checkout.com integration setup guide if you don’t have one yet.
2. Ask Checkout.com support to enable TWINT on your Checkout.com account.
3. In the Payrails Portal, go to Settings → Integrations, open your Checkout.com integration, select TWINT under Payment methods, and save.
4. Add TWINT as a payment option in your workflow.

​

Request fields for Checkout.com

​

Authorize a TWINT payment

{
  "amount": {
    "value": "25.00",
    "currency": "CHF"
  },
  "paymentComposition": [
    {
      "integrationType": "api",
      "paymentMethodCode": "twint",
      "amount": {
        "value": "25.00",
        "currency": "CHF"
      }
    }
  ],
  "meta": {
    "customer": {
      "email": "noah.meier@example.com",
      "name": "Noah",
      "lastName": "Meier"
    }
  },
  "returnInfo": {
    "success": "https://example.com/success",
    "error": "https://example.com/error"
  }
}

​

How Checkout.com handles TWINT

• Payrails creates the TWINT payment through the Checkout.com Payment Setup API. Checkout.com needs no payment token for TWINT.
• Payrails rejects a partial capture request for TWINT, and sends every TWINT capture to Checkout.com as a final capture.
• If Checkout.com doesn’t return a redirect for a pending TWINT payment, Payrails fails the payment, because the customer can’t complete it.
• Payrails doesn’t save the TWINT payment method at Checkout.com, so Save Instruments and MIT aren’t available.