Checkout

Global payments are complex and ever-evolving. So we’ve built the technology and expertise to help you succeed - one transaction at a time.

Source: https://www.checkout.com/

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 (asynchrone workflow)

Additional features

Information request and CIT

MIT

Server-to-server

How to test?

Basic test cards

Credentials	Yes Card	No Card
Card number	4242 4242 4242 4242	4243 7542 7170 0719
Expiry date	any future month and year	any future month and year
CVC	any 3 randoms numbers	any 3 randoms numbers

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.currency_code	Yes
customer.reference(Only for tokenization)	No
customer.ip	No
customer.billing_address.last_name	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
shipments.shipping_address.address_lines	No
shipments.shipping_address.city	No
shipments.shipping_address.postal_code	No
shipments.shipping_address.country_code	No

Payment Labels

Label	Method	Payment type
checkout	creditcard	primary (credit card)

Actions

Action	Mandatory fields	Optional fields
APPLY	amount 20	-

Status

PSP status	State	Code	Description
10000	SUCCESS	SUCCEEDED	Approved
10008	SUCCESS	SUCCEEDED	Approved - Honor with ID (Debit Cards)
10011	SUCCESS	SUCCEEDED	Approved - VIP (not used)
10076	SUCCESS	SUCCEEDED	Approved (Country Club)
10077	SUCCESS	SUCCEEDED	Approved (Local Banks)
10081	SUCCESS	SUCCEEDED	Approved (Approved Commercial)
10100	SUCCESS	SUCCEEDED	Flagged as a potentially risky transaction
10200	SUCCESS	SUCCEEDED	Deferred capture
20001	ERROR	FAILED	Refer to card issuer - Contact card issuer
20002	ERROR	FAILED	Refer to card issuer - Special conditions
20003	ERROR	BAD_REQUEST	Invalid merchant or service provider
20005	ERROR	FAILED	Declined - Do not honour
20006	ERROR	BAD_REQUEST	Error / Invalid request parameters
20009	WAITING	WAITING_PARTNER_RESPONSE	Request in progress
20010	SUCCESS	SUCCEEDED	Partial value approved
20012	ERROR	FAILED	Invalid transaction
20013	ERROR	BAD_REQUEST	Invalid value/amount
20014	ERROR	WRONG_CARD_DATA	Invalid account number (no such number)
20017	CUSTOMER	BLOCKED_BY_CUSTOMER	Customer cancellation
20018	ERROR	FAILED	Customer dispute
20019	ERROR	FAILED	Re-enter transaction
20020	ERROR	FAILED	Invalid response
20021	ERROR	FAILED	No action taken (unable to back out prior transaction)
20022	ERROR	FAILED	Suspected malfunction
20023	ERROR	FAILED	Unacceptable transaction fee
20024	ERROR	FAILED	File update not supported by the receiver
20025	ERROR	FAILED	Unable to locate record on file
20026	ERROR	FAILED	Duplicate file update record
20027	ERROR	FAILED	File update field edit error
20028	ERROR	FAILED	File is temporarily unavailable
20029	ERROR	FAILED	File update not successful
20030	ERROR	BAD_REQUEST	Format error
20031	ERROR	BAD_REQUEST	Bank not supported by Switch
20032	SUCCESS	SUCCEEDED	Completed partially
20038	ERROR	FAILED	Allowable PIN tries exceeded
20039	ERROR	FAILED	No credit account
20040	ERROR	FAILED	Requested function not supported
20042	ERROR	FAILED	No universal value/amount
20044	ERROR	FAILED	No investment account
20046	ERROR	REJECTED_BANK	Bank decline
20051	ERROR	INSUFFICIENT_FUNDS	Insufficient funds
20052	ERROR	FAILED	No current (checking) account
20053	ERROR	FAILED	No savings account
20054	ERROR	CARD_EXPIRED	Expired card
20055	ERROR	FAILED	Incorrect PIN
20056	ERROR	FAILED	No card record
20057	ERROR	FAILED	Transaction not permitted to cardholder
20058	ERROR	FAILED	Transaction not permitted to terminal
20059	ERROR	REJECTED_BY_RISK_CHECKS	Suspected fraud
20060	ERROR	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Card acceptor contact acquirer
20061	ERROR	AMOUNT_EXCEEDED	Activity amount limit exceeded
20062	ERROR	FAILED	Restricted card
20063	ERROR	REJECTED_BY_RISK_CHECKS	Security violation
20064	ERROR	TECHNICAL_ISSUE_DURING_AUTHENTICATION_CHECK	Transaction does not fulfil AML requirement
20065	ERROR	TECHNICAL_ISSUE_DURING_AUTHENTICATION_CHECK	Exceeds Withdrawal Frequency Limit
20066	ERROR	TECHNICAL_ISSUE_DURING_AUTHENTICATION_CHECK	Card acceptor call acquirer security
20067	ERROR	REJECTED_BY_RISK_CHECKS	Hard capture - Pick up card at ATM
20068	ERROR	EXPIRED_AUTHORIZATION	Response received too late / Timeout
20075	ERROR	FAILED	Allowable PIN-entry tries exceeded
20078	ERROR	BLOCKED_CARD	Blocked card. First-time card usage.
20082	ERROR	REJECTED_BY_RISK_CHECKS	No security model
20083	ERROR	FAILED	No accounts
20084	ERROR	FAILED	No PBF
20085	ERROR	FAILED	PBF update error
20086	ERROR	BAD_REQUEST	ATM malfunction/Invalid authorization type
20087	ERROR	BAD_REQUEST	Bad track data (invalid CVV and/or expiry date)
20088	ERROR	FAILED	Unable to dispense/process
20089	ERROR	FAILED	Administration error
20090	WAITING	WAITING_PARTNER_RESPONSE	Cut-off in progress
20091	ERROR	FAILED	Issuer unavailable or switch is inoperative
20092	ERROR	BAD_REQUEST	Destination cannot be found for routing
20093	ERROR	FAILED	Transaction cannot be completed; violation of law
20094	ERROR	DUPLICATED_TRANSACTION	Duplicate transmission / invoice
20095	ERROR	FAILED	Reconcile error
20096	ERROR	FAILED	System malfunction
20097	SUCCESS	SUCCEEDED	Reconciliation totals reset
20098	ERROR	FAILED	MAC error
20099	ERROR	UNKNOWN	Other / Unidentified responses
20100	ERROR	CARD_EXPIRED	Invalid expiry date format
20102	ERROR	FAILED	Invalid merchant / wallet ID
20103	ERROR	TRANSACTION_NOT_SUPPORTED_BY_MERCHANT_ACCOUNT	Card type / payment method not supported
20104	ERROR	FAILED	Gateway reject - Invalid transaction
20105	ERROR	FAILED	Gateway reject - Violation
20106	ERROR	FAILED	Unsupported currency
20107	ERROR	BAD_REQUEST	Billing address is missing
20108	SUCCESS	SUCCEEDED	Declined - Updated cardholder available
20109	ERROR	FAILED	Transaction already reversed (voided)
20110	SUCCESS	SUCCEEDED	Authorization completed
20111	ERROR	FAILED	Transaction already reversed
20112	ERROR	FAILED	Merchant not Mastercard SecureCode enabled
20113	ERROR	BAD_REQUEST	Invalid property
20115	ERROR	BAD_REQUEST	Missing / Invalid lifetime
20116	ERROR	BAD_REQUEST	Invalid encoding
20117	ERROR	BAD_REQUEST	Invalid API version
20118	WAITING	WAITING_PARTNER_RESPONSE	Transaction pending
20119	ERROR	BAD_REQUEST	Invalid batch data and/or batch data is missing
20120	ERROR	BAD_REQUEST	Invalid customer/user
20121	ERROR	TECHNICAL_ISSUE_DURING_AUTHENTICATION_CHECK	Transaction limit for merchant/terminal exceeded
20123	ERROR	BAD_REQUEST	Missing basic data: zip, addr, member
20124	ERROR	BAD_REQUEST	Missing CVV value, required for ecommerce transaction
20150	ERROR	FAILED	Card not 3D Secure (3DS) enabled
20151	ERROR	REJECTED_BY_RISK_CHECKS	Cardholder failed 3DS authentication
20152	ERROR	REJECTED_BY_RISK_CHECKS	Initial 3DS transaction not completed within 15 minutes
20153	ERROR	REJECTED_BY_RISK_CHECKS	3DS system malfunction
20154	SUCCESS	SUCCEEDED	3DS authentication required
20155	ERROR	BAD_REQUEST	3DS authentication service provided invalid authentication result
20156	ERROR	FAILED	Requested function not supported by the acquirer
20157	ERROR	TECHNICAL_ISSUE_TO_CONTACT_PARTNER	Invalid merchant configurations - Contact Support
20158	ERROR	REFUND_REQUESTED_TOO_LATE	Refund validity period has expired
20179	ERROR	FAILED	Lifecycle
20182	ERROR	FAILED	Policy
20183	ERROR	REJECTED_BY_RISK_CHECKS	Security
30004	ERROR	REJECTED_BY_RISK_CHECKS	Pick up card (No fraud)
30007	ERROR	REJECTED_BY_RISK_CHECKS	Pick up card - Special conditions
30015	ERROR	REJECTED_BY_RISK_CHECKS	No such issuer
30016	ERROR	REJECTED_BY_RISK_CHECKS	Issuer does not allow online gambling payout
30017	ERROR	REJECTED_BY_RISK_CHECKS	Issuer does not allow original credit transaction
30018	ERROR	REJECTED_BY_RISK_CHECKS	Issuer does not allow money transfer payout
30019	ERROR	REJECTED_BY_RISK_CHECKS	Issuer does not allow non-money transfer payout
30020	SUCCESS	SUCCEEDED	Invalid amount
30021	ERROR	AMOUNT_EXCEEDED	Total amount limit reached
30022	ERROR	REJECTED_BY_RISK_CHECKS	Total transaction count limit reached
30033	ERROR	REJECTED_BY_RISK_CHECKS	Expired card - Pick up
30034	ERROR	REJECTED_BY_RISK_CHECKS	Suspected fraud - Pick up
30035	ERROR	REJECTED_BY_RISK_CHECKS	Contact acquirer - Pick up
30036	ERROR	REJECTED_BY_RISK_CHECKS	Restricted card - Pick up
30037	ERROR	REJECTED_BY_RISK_CHECKS	Call acquirer security - Pick up
30038	ERROR	REJECTED_BY_RISK_CHECKS	Allowable PIN tries exceeded - Pick up
30041	ERROR	REJECTED_BY_RISK_CHECKS	Lost card - Pick up
30043	ERROR	REJECTED_BY_RISK_CHECKS	Stolen card - Pick up
30044	ERROR	REJECTED_BY_RISK_CHECKS	Transaction rejected - AMLD5
30045	ERROR	REJECTED_BY_RISK_CHECKS	Invalid payout fund transfer type
30046	ERROR	REJECTED_BY_RISK_CHECKS	Closed account
40101	ERROR	REJECTED_BY_RISK_CHECKS	Risk blocked transaction
40201	ERROR	REJECTED_BY_RISK_CHECKS	Gateway reject - card number blacklist
40202	ERROR	REJECTED_BY_RISK_CHECKS	Gateway reject - IP address blacklist
40203	ERROR	REJECTED_BY_RISK_CHECKS	Gateway reject - email blacklist
40204	ERROR	REJECTED_BY_RISK_CHECKS	Gateway reject - phone number blacklist
40205	ERROR	REJECTED_BY_RISK_CHECKS	Gateway Reject - BIN number blacklist
Paid	SUCCESS	SUCCEEDED	Transaction paid
2006P	ERROR	FAILED	Cardholder ID verification failed
200N0	ERROR	FAILED	Force STIP
200N7	ERROR	FAILED	Decline for CVV2 failure
200O5	ERROR	FAILED	PIN required
200P1	ERROR	FAILED	Over daily limit
200P9	ERROR	FAILED	Limit exceeded. Enter a lesser value.
200R1	ERROR	TECHNICAL_ISSUE_DURING_AUTHENTICATION_CHECK	Issuer initiated a stop payment (revocation order) for this authorization
200R3	ERROR	TECHNICAL_ISSUE_DURING_AUTHENTICATION_CHECK	Issuer initiated a stop payment (revocation order) for all authorizations
200S4	ERROR	TECHNICAL_ISSUE_DURING_AUTHENTICATION_CHECK	PTLF full
200T2	ERROR	FAILED	Invalid transaction date
200T3	ERROR	FAILED	Card not supported
200T5	ERROR	FAILED	CAF status = 0 or 9
Voided	SUCCESS	SUCCEEDED	Transaction voided
Expired	ERROR	EXPIRED_AUTHORIZATION	Transaction expired
FAILURE	ERROR	FAILED	Unsuccessful task
Pending	SUCCESS	SUCCEEDED	Transaction pending
SUCCESS	SUCCESS	SUCCEEDED	Successful task
Canceled	SUCCESS	SUCCEEDED	Transaction canceled
Captured	SUCCESS	SUCCEEDED	Transaction captured
Declined	ERROR	FAILED	Transaction declined
Refunded	SUCCESS	SUCCEEDED	Transaction refunded
Authorized	SUCCESS	SUCCEEDED	Transaction authorized
token_used	ERROR	BAD_REQUEST	The Checkout.com token has already been used.
cvv_invalid	ERROR	BAD_REQUEST	The CVV is invalid.
zip_invalid	ERROR	BAD_REQUEST	The first part of the UK postcode is invalid.
card_expired	ERROR	BAD_REQUEST	The card is expired.
city_invalid	ERROR	BAD_REQUEST	The city from which the charge originated is invalid.
email_in_use	ERROR	BAD_REQUEST	The email address is already in use.
token_in_use	ERROR	BAD_REQUEST	The Checkout.com token is in use.
Card Verified	SUCCESS	SUCCEEDED	Card verified
UNKNOWN_ERROR	ERROR	UNKNOWN	Unknow error
card_disabled	ERROR	BAD_REQUEST	The card is disabled.
email_invalid	ERROR	BAD_REQUEST	The email address is invalid.
token_expired	ERROR	BAD_REQUEST	The Checkout.com token has expired.
token_invalid	ERROR	BAD_REQUEST	The Checkout.com token is invalid.
amount_invalid	ERROR	BAD_REQUEST	The payment amount is invalid.
card_not_found	ERROR	BAD_REQUEST	The card is not found.
email_required	ERROR	BAD_REQUEST	The email address is required.
invalid_action	ERROR	BAD_REQUEST	Workflow error
source_invalid	ERROR	BAD_REQUEST	The payment source is invalid.
token_required	ERROR	BAD_REQUEST	The Checkout.com token is required.
3ds_malfunction	ERROR	BAD_REQUEST	3DS has malfunctioned.
address_invalid	ERROR	BAD_REQUEST	The shipping address is invalid.
country_invalid	ERROR	BAD_REQUEST	The two-letter ISO country code of the payment source owner's billing address is invalid.
payment_expired	ERROR	BAD_REQUEST	The payment has expired.
payment_invalid	ERROR	BAD_REQUEST	The payment is invalid.
request_invalid	ERROR	BAD_REQUEST	The request is invalid.
business_invalid	ERROR	BAD_REQUEST	The business settings are invalid.
currency_invalid	ERROR	BAD_REQUEST	The three-letter ISO currency code is invalid.
endpoint_invalid	ERROR	BAD_REQUEST	The endpoint is invalid.
fail_url_invalid	ERROR	BAD_REQUEST	The failure URL is invalid.
password_invalid	ERROR	BAD_REQUEST	The password is invalid.
processing_error	ERROR	BAD_REQUEST	There is a processing error.
void_not_allowed	ERROR	BAD_REQUEST	Void not allow.
3ds_not_supported	ERROR	BAD_REQUEST	3DS is not supported.
currency_required	ERROR	BAD_REQUEST	The three-letter ISO currency code is required.
customer_mismatch	ERROR	BAD_REQUEST	There is a customer mismatch.
parameter_invalid	ERROR	BAD_REQUEST	The parameter is invalid.
source_id_invalid	ERROR	BAD_REQUEST	The payment source identifier is invalid.
source_id_unknown	ERROR	BAD_REQUEST	The payment source identifier is unknown.
wallet_id_invalid	ERROR	BAD_REQUEST	The wallet identifier is invalid.
3ds_not_configured	ERROR	BAD_REQUEST	3DS is not configured.
Partially Captured	SUCCESS	SUCCEEDED	Transaction partially captured
Partially Refunded	SUCCESS	SUCCEEDED	Transaction partially refunded
customer_not_found	ERROR	BAD_REQUEST	The customer's details cannot be found.
ip_address_invalid	ERROR	BAD_REQUEST	The IP address used to make the payment is invalid.
last_name_required	ERROR	BAD_REQUEST	The account holder's last name is required.
refund_not_allowed	ERROR	BAD_REQUEST	Refund not allow.
source_id_required	ERROR	BAD_REQUEST	The payment source identifier is required.
token_data_invalid	ERROR	BAD_REQUEST	The token data is invalid.
token_type_invalid	ERROR	BAD_REQUEST	The token type is invalid.
3ds_version_invalid	ERROR	BAD_REQUEST	The 3DS version is invalid.
capture_not_allowed	ERROR	BAD_REQUEST	Capture not allow.
card_holder_invalid	ERROR	BAD_REQUEST	The cardholder is invalid.
card_number_invalid	ERROR	BAD_REQUEST	The card number is invalid.
channel_url_missing	ERROR	BAD_REQUEST	The channel URL is missing.
customer_id_invalid	ERROR	BAD_REQUEST	The customer identifier is invalid.
first_name_required	ERROR	BAD_REQUEST	The account holder's first name is required.
service_unavailable	ERROR	BAD_REQUEST	The service is unavailable.
success_url_invalid	ERROR	BAD_REQUEST	The success URL provided is invalid.
token_type_required	ERROR	BAD_REQUEST	The Checkout.com token type is required.
void_amount_invalid	ERROR	BAD_REQUEST	The void request amount is invalid.
3ds_payment_required	ERROR	BAD_REQUEST	3DS payment required.
card_number_required	ERROR	BAD_REQUEST	The card number is required.
metadata_key_invalid	ERROR	BAD_REQUEST	The metadata key is invalid.
payment_type_invalid	ERROR	BAD_REQUEST	The payment type is invalid.
phone_number_invalid	ERROR	BAD_REQUEST	The phone number associated with the shipping address is invalid.
request_json_invalid	ERROR	BAD_REQUEST	The JSON in the request is invalid.
source_email_invalid	ERROR	BAD_REQUEST	The payment source owner's email address is invalid.
source_token_invalid	ERROR	BAD_REQUEST	The Checkout.com token is invalid.
source_type_required	ERROR	BAD_REQUEST	The payment source type is required.
recipient_dob_invalid	ERROR	BAD_REQUEST	The recipient's date of birth (YYYY-MM-DD) is invalid.
recipient_zip_invalid	ERROR	BAD_REQUEST	The first part of the recipient's UK postcode is required.
recurring_plan_exists	ERROR	BAD_REQUEST	The recurring plan exists.
refunds_not_supported	ERROR	BAD_REQUEST	Refund requests are not supported.
risk_enabled_required	ERROR	BAD_REQUEST	The risk check that is enabled is required.
source_email_required	ERROR	BAD_REQUEST	The payment source owner's email address is required.
source_token_required	ERROR	BAD_REQUEST	The Checkout.com token number is required.
amount_exceeds_balance	ERROR	BAD_REQUEST	The payment amount exceeds the balance.
charge_details_invalid	ERROR	BAD_REQUEST	The charge details are invalid.
customer_email_invalid	ERROR	BAD_REQUEST	The email address associated with the customer is invalid.
payment_method_invalid	ERROR	BAD_REQUEST	The payment method is invalid.
payments_not_supported	ERROR	BAD_REQUEST	Payments are not supported.
recipient_dob_required	ERROR	BAD_REQUEST	The recipient's date of birth (YYYY-MM-DD) is required.
recipient_zip_required	ERROR	BAD_REQUEST	The first part of the recipient's UK postcode is required.
server_api_not_allowed	ERROR	BAD_REQUEST	The full API is not enabled on your sandbox account. To enable it, please contact our Integration team at [email protected].
channel_details_invalid	ERROR	BAD_REQUEST	The channel details are invalid.
country_address_invalid	ERROR	BAD_REQUEST	The first or second line of the payment source owner's billing address is invalid.
customer_already_exists	ERROR	BAD_REQUEST	The customer details already exist.
customer_number_invalid	ERROR	BAD_REQUEST	The customer number is invalid.
payment_source_required	ERROR	BAD_REQUEST	The payment source linked to a specific customer is required.
processing_key_required	ERROR	BAD_REQUEST	The processing key is required.
3ds_not_enabled_for_card	ERROR	BAD_REQUEST	3DS is not enabled for card.
api_calls_quota_exceeded	ERROR	BAD_REQUEST	The quota for API calls has been exceeded.
card_expiry_year_invalid	ERROR	BAD_REQUEST	The four-digit expiry year is invalid.
customer_plan_id_invalid	ERROR	BAD_REQUEST	The customer plan identifier is invalid.
recurring_plan_not_exist	ERROR	BAD_REQUEST	The recurring plan does not exist.
3ds_version_not_supported	ERROR	BAD_REQUEST	The 3DS version is not supported.
business_settings_missing	ERROR	BAD_REQUEST	The business settings are missing.
card_authorization_failed	ERROR	BAD_REQUEST	The card authorization has failed.
card_expiry_month_invalid	ERROR	BAD_REQUEST	The two-digit expiry month is invalid.
card_expiry_year_required	ERROR	BAD_REQUEST	A four-digit expiry year is required.
customer_plan_edit_failed	ERROR	BAD_REQUEST	Editing the customer plan has failed.
processing_value_required	ERROR	BAD_REQUEST	The processing value is required.
source_token_type_invalid	ERROR	BAD_REQUEST	The source token type is invalid.
card_expiry_month_required	ERROR	BAD_REQUEST	A two-digit expiry month is required.
country_phone_code_invalid	ERROR	BAD_REQUEST	The international country calling code is invalid.
expiry_date_format_invalid	ERROR	BAD_REQUEST	The expiry date format is invalid.
issuer_network_unavailable	ERROR	BAD_REQUEST	The issuer network is unavailable.
source_token_type_required	ERROR	BAD_REQUEST	The source token type is required.
sub_entities_count_invalid	ERROR	BAD_REQUEST	This account type cannot request a split payment for multiple sub-entities.
phone_number_length_invalid	ERROR	BAD_REQUEST	The length of the phone number associated with the shipping address is invalid.
previous_payment_id_invalid	ERROR	BAD_REQUEST	The previous payment identifier is invalid.
source_id_or_email_required	ERROR	BAD_REQUEST	The payment source identifier or email address is required.
payment_method_not_supported	ERROR	BAD_REQUEST	The payment method is not supported.
recipient_last_name_required	ERROR	BAD_REQUEST	The recipient's last name is required.
action_failure_limit_exceeded	ERROR	BAD_REQUEST	The quota of failed payment actions has been exceeded.
payment_source_does_not_exist	ERROR	BAD_REQUEST	The payment source does not exist.
recurring_plan_removal_failed	ERROR	BAD_REQUEST	Removing the recurring plan has failed.
source_or_destination_required	ERROR	BAD_REQUEST	The payment source or destination is required.
billing_descriptor_city_invalid	ERROR	BAD_REQUEST	The city from which the charge originated is invalid.
billing_descriptor_name_invalid	ERROR	BAD_REQUEST	The dynamic description of the charge is invalid.
billing_descriptor_city_required	ERROR	BAD_REQUEST	The city from which the charge originated is required.
billing_descriptor_name_required	ERROR	BAD_REQUEST	A dynamic description of the charge is required.
recipient_account_number_invalid	ERROR	BAD_REQUEST	The recipient's account number is invalid.
country_phone_code_length_invalid	ERROR	BAD_REQUEST	The international country calling code length is invalid.
recipient_account_number_required	ERROR	BAD_REQUEST	The recipient's account number is required.
capture_value_greater_than_authorized	ERROR	BAD_REQUEST	The capture value is greater than the authorized value.
capture_value_greater_than_remaining_authorized	ERROR	BAD_REQUEST	The capture value is greater than the remaining authorized value.