TWINT for API only
Last updated: December 3, 2025
To accept TWINT payments, you must follow these steps:
- Request a payment.
- Redirect the customer.
- If you are using a manual capture payment, you must also capture the payment.
To send a payment request, call the Request a payment endpoint:
post
https://api.checkout.com/payments
If you receive a 202 Accepted response with a payment id value and the status field set to Pending, your request was successful.
The redirection step varies depending on whether you request the payment from:
- A desktop browser
- A mobile browser
- Ensure that the TWINT App is installed on your customer's phone.
- Redirect your customer to the
_links.redirect.hrefURL provided in the response.
The URL displays a QR code. - Your customer must scan the code using their TWINT app and confirm the payment on their device.
- After confirming the payment, they are redirected to either your success or failure URL.
Information
The code becomes invalid after five minutes. The payment expires if the customer does not confirm the payment within this time frame.
To request a payment from a mobile browser:
- Ensure that the TWINT app is installed on your customer's phone.
- Redirect your customer to the
_links.redirect.hrefURL provided in the response.
The URL displays the various TWINT apps that your customer can choose from. - The chosen TWINT app opens on your customer's device for them to authorize the payment.
- After authorizing the payment, they are redirected to either your success or failure URL.
The manual capture flow enables you to manually trigger the capture of the authorized funds at a later time. For example, if you need to verify that the item is in stock.
TWINT only supports full captures. You must send a capture request for the full authorized amount including "capture_type": "Final".
The standard authorization validity period for TWINT is seven days. However, you can extend this period up to 30 days during your onboarding, or after going live by contacting your account manager or request support.
To retrieve details about the payment, call the Get payment details endpoint, setting the payment_id value from the payment response as the {id} path parameter:
get
https://api.checkout.com/payments/{id}
See Get payment details for more information.
TWINT supports both partial and full refunds.
You can refund the payment in the Dashboard or by calling the Refund a payment endpoint, setting the payment_id value from the payment response as the {id} path parameter:
post
https://api.checkout.com/payments/{id}/refunds
TWINT recommends that you also provide the original payment's reference ID:
If the customer does not complete the payment, it expires and you receive a payment_expired webhook within five minutes.
If the customer cancels their payment, you also receive a payment_expired webhook.
See Void a payment for more information.