{"title":"API only with raw card data","category":"default","creationDate":1567783140,"content":"

Use our APIs to accept card payments with raw card data, and build your own UI to have full control over the look and feel of your checkout page.<\/p>\n

\n

To collect raw card data, you need to be fully PCI compliant<\/a>. If you are not fully PCI compliant, use one of our pre-built UI solutions<\/a> or build a custom card integration with encryption<\/a> instead.<\/p>\n<\/div>\n

Requirements<\/h2>\n\n\n\n\n\n\n
Requirement<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
Integration type<\/strong><\/td>\nMake sure that you have built an API-only integration<\/a>. <\/td>\n<\/tr>\n
Setup steps<\/strong><\/td>\nBefore you begin, add the cards that you want to support in your test Customer Area<\/a>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Build your payment form for cards<\/h2>\n

When making a card payment, collect the following shopper details:<\/p>\n\n\n\n\n\n\n\n\n\n
Card details<\/th>\nExample input<\/th>\nRequired<\/th>\n<\/tr>\n<\/thead>\n
Card number<\/td>\n\"4111111111111111\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Card expiry month<\/td>\n\"03\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Card expiry year<\/td>\n\"30\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Card security code (CVV \/ CVC)<\/td>\n\"737\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
Cardholder name<\/td>\n\"S. Hopper\"<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Showing co-badged cards<\/h3>\n

For cards issued in some countries\/regions, you must comply with regulations for co-badged cards<\/a>.<\/p>\n

Use the \/cardDetails<\/a> endpoint to identify the brands on the shopper's card. To identify the brands, start making \/cardDetails<\/a> requests while the shopper is entering the card number. You need a minimum of the first 8 digits, but the full card number gives the best result.<\/p>\n

If the \/cardDetails<\/a> endpoint identifies two brands and you support both, you must let the shopper choose which brand to pay with. If you only support one brand, let the shopper pay with it.<\/p>\n

    \n
  1. \n

    Make a POST<\/strong><\/span> \/cardDetails<\/a> request including the following:<\/p>\n\n\n\n\n\n\n\n\n
    Parameter<\/th>\nDescription<\/th>\nRequired<\/th>\n<\/tr>\n<\/thead>\n
    merchantAccount<\/code><\/td>\nYour merchant account.<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
    cardNumber<\/code><\/td>\nA minimum of the first 8 digits of the card number and a maximum of the full card number.<\/td>\n\"-white_check_mark-\"<\/td>\n<\/tr>\n
    countryCode<\/code><\/td>\nThe shopper's country. The country code of the terminal's location.
    Format: the two-letter ISO-3166-1 alpha-2<\/a> country code. Exception: QZ<\/strong> (Kosovo).<\/td>\n    		<\/td>\n<\/tr>\n
    supportedBrands<\/code><\/td>\nThe array of the card brands that you support. This is the brands<\/a> array from your \/paymentMethods<\/a> response. If not provided, we assume that you support all card brands.<\/td>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n<\/code-sample>\n<\/div>\n<\/li>\n
  2. \n

    The response has a brands<\/code> array containing the brands on the card. If you included supportedBrands<\/code> in the request, the response shows the ones you support.<\/p>\n

    The following example shows a response where:<\/p>\n