Ingenico Twint

With over 3.5 million active users, TWINT is the most popular payment method in Switzerland. By linking their bank accounts, credit cards or prepaid cards with the TWINT app, your customers can pay low amount transactions easily (i.e. pay-by-phone parking, food ordering or invoicing).

Source: https://www.twint.ch/en/

Features

Integration type

Embed (no redirection)

Tokenization

Yes

Payment Flow

1-step payment flow : Capture (direct debit)

2-step payment flow : Authorization + Capture

3-step payment flow : Pending Authorization + Authorization + Capture

Additional features

Information request and CIT

MIT

Server-to-server

How to test?

Test Cases

Use cases	Amount
Cancelled payment	1302
Expired payment	1402
Unsuccessful authorisations	1502

See more test cards

Data Mapping & Mandatory Fields

Below is the mapping between your Create Session request and the fields expected by this payment method.

Purse Session field	Mandatory
amount	Yes
order.redirection	Yes
order.amount	No
order.currency_code	Yes
customer.reference	No
customer.company_name	No
customer.gender_code	No
customer.first_name	No
customer.last_name	No
customer.birthdate	No
customer.ip	No
customer.locale_code	No
customer.billing_address.address_lines	No
customer.billing_address.city	No
customer.billing_address.postal_code	No
customer.billing_address.country_code	No
customer.billing_address.email	No
customer.billing_address.phone	No
customer.billing_address.mobile_phone	No
customer.billing_address.work_phone	No
customer.account.purchase_count_last_day	No
customer.account.purchase_count_last_six_months	No
customer.account.purchase_count_last_year	No
customer.account.different_card_count_last_day	No
customer.account.authentication_method	No
customer.account.authentication_date_time	No
customer.account.update_date_time	No
customer.account.creation_date_time	No
customer.account.password_update_date_time	No
customer.account.three_ds_exemption	No
customer.account.challenge_indicator	No
shipments.shipping_address.address_lines	No
shipments.shipping_address.city	No
shipments.shipping_address.postal_code	No
shipments.shipping_address.country_code	No
shipments.shipping_address.email	No
shipments.item_lines.name	No
shipments.item_lines.price	No
shipments.item_lines.quantity	No
shipments.item_lines.amount	No
shipments.item_lines.tax_lines.amount	No

Payment Labels

Label	Method	Payment type
ingenico	twint	primary

Actions

Action	Mandatory fields	Optional fields
APPLY	amount 20	-

Status

PSP status	State	Code	Description
1000	ERROR	FAILED	Do not honour
1001	ERROR	CARD_EXPIRED	Expired card
1002	ERROR	REJECTED_BY_RISK_CHECKS	Suspected fraud
1003	ERROR	FAILED	Card acceptor contact acquirer
1004	ERROR	FAILED	Restricted card
1005	ERROR	FAILED	Card acceptor call acquirer's security department
1006	ERROR	BLOCKED_CARD	Allowable PIN tries exceeded
1007	ERROR	FAILED	Refer to card issuer
1008	ERROR	FAILED	Refer to card issuer's special conditions
1009	ERROR	FAILED	Invalid card acceptor
1010	ERROR	BAD_REQUEST	Successful
1011	ERROR	WRONG_CARD_DATA	Invalid card number
1012	ERROR	BAD_REQUEST	PIN data required
1013	ERROR	BAD_REQUEST	Unacceptable fee
1014	ERROR	BAD_REQUEST	No account of type requested
1015	ERROR	BAD_REQUEST	Requested function not supported
1016	ERROR	INSUFFICIENT_FUNDS	Not sufficient funds
1017	ERROR	FAILED	Incorrect PIN
1018	ERROR	FAILED	No card record
1019	ERROR	FAILED	Transaction not permitted to cardholder
1020	ERROR	FAILED	Transaction not permitted to terminal
1021	ERROR	AMOUNT_EXCEEDED	Exceeds withdrawal amount limit
1022	ERROR	FAILED	Security violation
1023	ERROR	FAILED	Exceeds withdrawal frequency limit
1024	ERROR	FAILED	Violation of law
1025	ERROR	CARD_IS_NOT_ACTIVE	Card not effective
1026	ERROR	FAILED	Invalid PIN block
1027	ERROR	BAD_REQUEST	PIN length error
1028	ERROR	FAILED	PIN key sync error
1029	ERROR	FAILED	Suspected counterfeit card
1030	ERROR	BAD_REQUEST	Currency unacceptable to card issuer
1031	ERROR	BAD_REQUEST	Not authorised and fees disputed
1032	ERROR	BLOCKED_CARD	Lost/stolen card
1033	ERROR	FAILED	Authorization lifecycle unacceptable
1034	ERROR	FAILED	Authorization lifecycle has expired
1035	ERROR	FAILED	Closed account
1036	ERROR	FAILED	Closed savings account, or restricted for closing
1037	ERROR	FAILED	Closed credit account or restricted for closing
1038	ERROR	FAILED	Closed credit facility cheque account or restricted for closing
1039	ERROR	FAILED	Closed cheque account or restricted for closing
1040	ERROR	FAILED	Bad debt
1041	ERROR	FAILED	From account bad status
1042	ERROR	FAILED	To account bad status
1043	ERROR	FAILED	Cheque already posted
1044	ERROR	FAILED	Information not on file
1045	ERROR	FAILED	Card verification data failed
1046	ERROR	BAD_REQUEST	Amount not found
1047	ERROR	BAD_REQUEST	PIN change required
1048	ERROR	BAD_REQUEST	New PIN invalid
1049	ERROR	BAD_REQUEST	Bank not found
1050	ERROR	BAD_REQUEST	Bank not effective
1051	ERROR	BAD_REQUEST	Customer vendor not found
1052	ERROR	BAD_REQUEST	Customer vendor not effective
1053	ERROR	BAD_REQUEST	Customer vendor account invalid
1054	ERROR	BAD_REQUEST	Vendor not found
1055	ERROR	BAD_REQUEST	Vendor not effective
1056	ERROR	BAD_REQUEST	Vendor data invalid
1057	ERROR	BAD_REQUEST	Payment date invalid
1058	ERROR	BAD_REQUEST	Personal identification not found
1059	ERROR	BAD_REQUEST
1060	ERROR	FAILED	Transaction did not complete normally at terminal
1061	ERROR	FAILED	Transaction not supported by the card issuer
1062	ERROR	FAILED	Cashback not allowed
1063	ERROR	FAILED	Cashback amount exceeded
1064	ERROR	FAILED	Declined, transaction processed offline by terminal
1065	ERROR	FAILED	Declined, terminal unable to process offline
1066	ERROR	FAILED	Declined, transaction processed offline after referral
1067	ERROR	FAILED	Reserved for ISO use
1068	ERROR	BAD_REQUEST	Identification number invalid
1069	ERROR	BAD_REQUEST	Driver number invalid
1070	ERROR	BAD_REQUEST	Vehicle number invalid
1071	ERROR	FAILED	Digital certificate expired
1099	ERROR	FAILED	Invalid value
2000	ERROR	FAILED	Do not honour
2001	ERROR	CARD_EXPIRED	Expired card
2002	ERROR	REJECTED_BY_RISK_CHECKS	Suspected fraud
2003	ERROR	FAILED	Card acceptor contact acquirer
2004	ERROR	FAILED	Restricted card
2005	ERROR	REJECTED_BY_RISK_CHECKS	Card acceptor call acquirer's security department
2006	ERROR	BLOCKED_CARD	Allowable PIN tries exceeded
2007	ERROR	FAILED	Special conditions
2008	ERROR	FAILED	Lost card
2009	ERROR	FAILED	Stolen card
2010	ERROR	REJECTED_BY_RISK_CHECKS	Suspected counterfeit card
2011	ERROR	FAILED	Daily withdrawal uses exceeded
2012	ERROR	FAILED	Daily withdrawal amount exceeded
4000	SUCCESS	SUCCEEDED	Accepted
9999	ERROR	FAILED	Other errors
30001100	ERROR	FAILED	Unauthorised customer country
30001101	ERROR	FAILED	IP country differs from card country
30001102	ERROR	BAD_REQUEST	Number of different countries too high
30001104	ERROR	FAILED	Unauthorised IP address country
30001105	ERROR	BAD_REQUEST	Anonymous proxy
30001106	ERROR	BAD_REQUEST	Unknown IP address country
30001120	ERROR	FAILED	IP address on merchant's blacklist
30001130	ERROR	FAILED	BIN on merchant's blacklist
30001140	ERROR	FAILED	Card on merchant's blacklist
30001141	ERROR	FAILED	E-mail blacklisted
30001142	ERROR	FAILED	Passenger name blacklisted
30001143	ERROR	FAILED	Cardholder name blacklisted
30001158	ERROR	BAD_REQUEST	E-mail usage limit reached
30001180	ERROR	BAD_REQUEST	Maximum scoring reached
30031001	ERROR	BAD_REQUEST	Invalid merchant number
30041001	ERROR	BAD_REQUEST	Retain card
30141001	ERROR	BAD_REQUEST	Invalid card number
30171001	ERROR	FAILED	Payment method cancelled by the customer
30331001	ERROR	CARD_EXPIRED	Card expired
30431001	ERROR	FAILED	Stolen card. Pick up.
30581001	ERROR	FAILED	Transaction not permitted on this terminal
30621001	ERROR	FAILED	Restricted card
30921001	ERROR	BAD_REQUEST	Invalid card type for acquirer
40001134	ERROR	FAILED	Authentication failed. Please retry or cancel.
40001135	ERROR	FAILED	Authentication temporarily unavailable. Please retry or cancel.
40001137	ERROR	FAILED	Your bank is temporarily unavailable. Please try again later or choose another payment method
40001139	ERROR	BAD_REQUEST	Authentication required. The financial institution insists on 3-D Secure.
50001081	ERROR	BAD_REQUEST	Received PARes format was invalid according to the 3-D Secure specifications
50001087	ERROR	BAD_REQUEST	This transaction requires authentication. Please check with your bank.
CREATED	WAITING	WAITING_PARTNER_RESPONSE	The transaction has been created and is still in a pending status. This is the initial status for any new transaction request on our platform.
CANCELLED	SUCCESS	SUCCEEDED	The transaction/authorisation has been cancelled by either your customer or yourself
REJECTED	ERROR	FAILED	The authorisation/refund request has been rejected by the acquirer
REJECTED_CAPTURE	ERROR	FAILED	The capture request has been rejected by the acquirer
REDIRECTED	SUCCESS	SUCCEEDED	You have redirected your customer : to her/his issuer for a 3-D Secure check or we have not received the 3-D Secure check result yet, to the payment portal of a third party (for i.e. PayPal, Multibanco, Klarna, Bizum transactions) or we have not received a transaction result from this third party yet
PENDING_CAPTURE	SUCCESS	SUCCEEDED	Your authorisation request was successful, but you still need to capture it to receive the funds
AUTHORIZATION_REQUESTED	WAITING	WAITING_PARTNER_RESPONSE	Our platform is processing your authorisation request and waiting for the result. As soon as we have received the result, we will update the status to either “REJECTED” or “PENDING_CAPTURE” accordingly
CAPTURE_REQUESTED	WAITING	WAITING_PARTNER_RESPONSE	Our platform is processing your capture request and waiting for the result. As soon as we have received the result, we will update the status to either “REJECTED_CAPTURE” or “CAPTURED” accordingly
CAPTURED	SUCCESS	SUCCEEDED	Your capture request (“CAPTURE_REQUESTED”) has been successful. You can expect to receive the funds for this transaction from your acquirer
REFUND_REQUESTED	WAITING	WAITING_PARTNER_RESPONSE	Our platform is processing your refund request and waiting for the result. As soon as we have received the result, we will update the status to either “REJECTED” or “REFUNDED” accordingly
REFUNDED	SUCCESS	SUCCEEDED	Your refund request (“REFUND_REQUESTED”) has been successful. You customer can expect to receive the funds for this transaction from her/his issuers
UNSUCCESSFUL	ERROR	FAILED	Your authorisation/capture/refund request has been unsuccessful
PENDING_PAYMENT	SUCCESS	SUCCEEDED	You are waiting for either : the final result of a transaction in status='CREATED', the result of a 3-D Secure check of a transaction in status='REDIRECTE'
PENDING_MERCHANT	SUCCESS	SUCCEEDED	This transaction is a pending status because either: You still need to capture it due to its status='PENDING_CAPTURE', You are waiting for a final result for transactions in status='CANCELLED'
PENDING_CONNECT_OR_3RD_PARTY	WAITING	WAITING_PARTNER_RESPONSE	We are waiting for a final result for your authorisation/capture/refund request
SUCCESS	SUCCESS	SUCCEEDED	Successful
UNKNOWN_ERROR	ERROR	UNKNOWN	Unknow error
0000	SUCCESS	SUCCEEDED	Approved
0001	SUCCESS	SUCCEEDED	Honour with identification
0002	SUCCESS	SUCCEEDED	Approved for partial amount
0003	SUCCESS	SUCCEEDED	Approved (VIP)
0004	SUCCESS	SUCCEEDED	Approved, update track 3
0005	SUCCESS	SUCCEEDED	Approved, account type specified by card issuer
0006	SUCCESS	SUCCEEDED	Approved for partial amount, account type specified by card issuer
0008	SUCCESS	SUCCEEDED	Approved but fees disputed
0009	SUCCESS	SUCCEEDED	Approved with overdraft
0010	SUCCESS	SUCCEEDED	Approved, customer reactivated
0011	SUCCESS	SUCCEEDED	Approved, terminal unable to process online
0012	SUCCESS	SUCCEEDED	Approved, transaction processed offline by terminal
0013	SUCCESS	SUCCEEDED	Approved, transaction processed offline after referral
9999_30051001	ERROR	REJECTED_BANK	Authorisation declined
9999_30511001	ERROR	INSUFFICIENT_FUNDS	Insufficient funds
9999_30591001	ERROR	REJECTED_BY_RISK_CHECKS	Suspicion of fraud
9999_50001054	ERROR	WRONG_CARD_DATA	Card number incorrect or incompatible
INVALID_ACTION	ERROR	BAD_REQUEST	Workflow error
ERROR	ERROR	BAD_REQUEST	Failed operation
SESSION_DATA_NOT_OK	SUCCESS	BAD_REQUEST	Session data doesn't meet the partner's requirements
TIMEOUT	UNCERTAIN	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Timeout while contacting partner
GET_STATUS_TIMEOUT	WAITING	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Timeout while contacting partner
GET_STATUS_PARTNER_ERROR	WAITING	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Received 5XX server error from partner when calling status