Checkout.com integration guide

Checkout.comCheckout.com Checkout.com is a gateway that allows to you collect card payments. This guide is intended to help you implement Checkout.com based on your preferred integration workflow.

Services and compatibility

Supported payment types
  • Card
Supported transaction types
  • Sale ( API )
  • Auth Only ( API )
  • Capture (partial and greater than) ( API )
  • Void ( API )
  • Refund (partial and multiple) ( API )
Supported processing currenciesAED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BWP, BYN, BZD, CAD, CDF, CHF, CLP, CNY, COP, CRC, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SEK, SGD, SHP, SLL, SOS, SRD, SVC, SZL, THB, TJS, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VND, VUV, WST, XAF, XCD, XOF, XPF, YER, ZAR, ZMW
3D Secure 1.x supportedYes
3D Secure 2.x supportedYes
Installments supportedNo

Gateway-specific information

  • Supporting the customer redirect workflow is required. For the 3D Secure Workflow, see 3DS requirements.
  • Configuring and utilizing webhooks is necessary as part of the 3DS workflow. For information about webhooks, see the Webhooks topic.
  • The security code must be present for the first transaction through CKO, meaning customers with cards on file will need to re-enter the CVV. For documentation about the security code on the first transaction, see Enabling security code verification.
  • paymentType is supported.

Configuration

Work with Integrations Support to add Checkout.com as a connection. You will need the following credentials from Checkout.com:

  • public key
  • private key

Required fields

There are no additional required fields.

Testing data

Use the following test card information to test your Checkout.com configuration.

BrandCard numberExpiration dateSecurity codeCardholder name3DS Password3DS ResultTransaction Result
Visa4242424242424242Any future date100AnyCheckout1!SuccessSuccess
Visa4242424242424242Any123AnyCheckout1!SuccessDecline
Visa4543474002249996Any future date956AnyNoneSuccessSuccess
Visa4543474002249996Any future date123AnyNoneSuccessDecline
Mastercard5436031030606378Any future date257AnyNoneSuccessSuccess
Mastercard5436031030606378Any future date123AnyNoneSuccessDecline
Mastercard2223000010479399Any future date299AnyCheckout1!SuccessSuccess
Mastercard2223000010479399Any future date123AnyCheckout1!SuccessDecline
Mastercard5199992312641465Any future date10AnyNoneSuccessSuccess
American Express345678901234564Any future date1051AnyN/AThe three DS system appears to be down. Please get a new payment form.Success
American Express378282246310005Any future date1000AnyN/AThe three DS system appears to be down. Please get a new payment form.N/A
Discover6011111111111117Any future date100AnyCheckout1!SuccessSuccess
Discover6011111111111117Any future date123AnyCheckout1!SuccessDecline
JCB3530111333300000Any future date100AnyN/AThe three DS system appears to be down. Please get a new payment form.Success
Visa4484070000035519Any future date257AnyN/AN/ASuccess
Mastercard5352151570003404Any future date100AnyN/AN/ASuccess

Status workflows

The status of a successful transaction with Checkout.com varies, depending on the options you choose.

SaleWhen isAuthOnly is false, successful sale transactions will have the following statuses:
  • pending*
  • settled
Auth onlyWhen isAuthOnly is true, successful sale transactions will have the following status:
  • authOnly
CaptureSuccessful capture transactions will have the following statuses:
  • pending*
  • settled
VoidSuccessful void transactions will have the following status:
  • voided
RefundSuccessful refund transactions will have the following statuses:
  • pending*
  • settled

*Pending status displays as "authorized" or "AUTHORIZED" in the Nexio Dashboard; it displays as 10, meaning "authorized", in the response when querying transactions (for more information about transactionStatus, see the appropriate transactionStatus table).

If you have any additional questions or feedback, contact us.


Did this page help you?