\n <\/div>\n\n
Key implementation notes<\/h2>\n
Make sure that your implementation adheres to the following:<\/p>\n
\n- Component only: drop-in and sessions are not supported. Use
checkout.create('scheme', ...)<\/code> with koreanAuthenticationRequired<\/code>: true<\/strong><\/span> and countryCode<\/code>: KR<\/strong><\/span>.<\/li>\n- All Korean-issued cards: the
kcp.cardTaxno<\/code> and kcp.cardPwd<\/code> fields are required for all Korean-issued cards - domestic cards, and co-branded Visa, Mastercard, JCB, Diners, and UnionPay cards issued in Korea. Do not scope this to korean_local_card<\/code> only.<\/li>\n- One-time payments: always include both
additionalData<\/code> fields.<\/li>\n- Tokenization: include both fields on the first (shopper-present) transaction only. Omit them on subsequent recurring charges.<\/li>\n
- Both fields together:
kcp.cardTaxno<\/code> and kcp.cardPwd<\/code> are validated as a pair - sending one without the other returns a validation error.<\/li>\n- No 3DS: this integration does not support 3D Secure. The KCP authentication fields serve as the alternative authentication mechanism mandated by Korean issuers.<\/li>\n
- No liability shift: because 3DS is not used, this flow does not provide liability shift on chargebacks.<\/li>\n
- Installments UI: the card component does not render an installments selector. Build and collect this in your own UI if you intend to offer installments.<\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/payment-methods\/cards\/korean-cards-direct\/web-component","articleFields":{"description":"Add KCP Direct Card Capture to your Components integration.","never_cache_twig":true,"parameters":{"tx_variant":"scheme","component_class_name":"KCP Direct Card Capture","component_class_lowercase":"card","integration":"Components","pm_directory":"scheme","payment_method":"KCP Direct Card Capture","action_type":"none"},"filters_component":true,"filters_config_folder":"payment-methods\/korean-cards-direct\/web\/component-web"},"algolia":[{"url":"https:\/\/docs.adyen.com\/payment-methods\/cards\/korean-cards-direct\/web-component","title":"KCP Direct Card Capture Web Component","content":"\nSessions are not supported for KCP Direct Card Capture.\n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Cards","lvl3":"KCP Direct Card Capture","lvl4":"KCP Direct Card Capture Web Component"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/payment-methods\/cards","lvl3":"https:\/\/docs.adyen.com\/payment-methods\/cards\/korean-cards-direct","lvl4":"\/payment-methods\/cards\/korean-cards-direct\/web-component"},"levels":5,"category":"Payment method","category_color":"green","tags":["Direct","Capture","Component"]},{"url":"https:\/\/docs.adyen.com\/payment-methods\/cards\/korean-cards-direct\/web-component?flow=Sessions flow&integration=Component","title":"Sessions flow Component","content":"\nSessions are not supported for KCP Direct Card Capture.\n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Cards","lvl3":"KCP Direct Card Capture","lvl4":"KCP Direct Card Capture Web Component"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/payment-methods\/cards","lvl3":"https:\/\/docs.adyen.com\/payment-methods\/cards\/korean-cards-direct","lvl4":"\/payment-methods\/cards\/korean-cards-direct\/web-component"},"levels":5,"category":"Payment method","category_color":"green","tags":["Sessions flow","Component"]},{"url":"https:\/\/docs.adyen.com\/payment-methods\/cards\/korean-cards-direct\/web-component?flow=Advanced flow&integration=Component","title":"Advanced flow Component","content":"Requirements\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nMake sure that you have an existing Advanced flow Web Components integration.\n \n\n\nSetup steps\nBefore you begin, add KCP Direct Card Capture in your Customer Area.\n\n\n\nImport KCP Direct Card Capture\nWhen you import Adyen Web, include Card.\n\n \nAdd additional configuration for KCP Direct Card Capture\nConfigure the Component with the following configuration object:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nkoreanAuthenticationRequired\n\nSet to true.\n\n\ncountryCode\n\nSet to KR.\n\n\n\nInitialize the card component with koreanAuthenticationRequired: true and countryCode: KR. This causes the component to render the two additional KCP fields below the standard card fields.\n\n \n\nThe component renders:\n\n\n\nField\nShopper input\nSent as\n\n\n\n\nCard number\nCard number\npaymentMethod.encryptedCardNumber\n\n\nExpiry date\nMM\/YY\npaymentMethod.encryptedExpiryMonth \/ encryptedExpiryYear\n\n\nSecurity code\nCVC\/CVV\npaymentMethod.encryptedSecurityCode\n\n\nCardholder birthdate or Corporate registration number\nYYMMDD (6 digits) or 10-digit number\nadditionalData[\"kcp.cardTaxno\"]\n\n\nFirst 2 digits of card password\n2 digits\nadditionalData[\"kcp.cardPwd\"]\n\n\n\nAll fields are required. The component enforces this on client-side before the form can be submitted.\nInitialize the Component for KCP Direct Card Capture\nTo initialize KCP Direct Card Capture, use the Card class.\n\n \n\nAdd additional parameters to your \/payments request\nWhen you make a payment, add the following parameters to the \/payments request:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nkcp.cardTaxno\n\nCard holder birthdate (private card) or corporate registration number (corporate card). Birthdate: YYMMDD (6 digits). Corporate: 10 digits. Max 10 digits. Required if kcp.cardPwd is present.\n\n\nkcp.cardPwd\n\nFirst 2 digits of the card holder's card PIN. Required if kcp.cardTaxno is present.\n\n\n\n\n \n\n\n \n\nRecurring payments\nEnsure the card component with koreanAuthenticationRequired: true is rendered whenever the shopper is present (initial purchase or initial save).\nCreate a token\nInclude the following parameters in your \/payments request.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nstorePaymentMethod\n\nSet to true.\n\n\nkcp.cardTaxno\n\nCard holder birthdate (private card) or corporate registration number (corporate card). Birthdate: YYMMDD (6 digits). Corporate: 10 digits. Max 10 digits. Required if kcp.cardPwd is present.\n\n\nkcp.cardPwd\n\nFirst 2 digits of the cardholder's card PIN. Required if kcp.cardTaxno is present.\n\n\nshopperInteraction\n\nSet to Ecommerce.\n\n\nrecurringProcessingModel\n\nSet to Subscription.\n\n\n\n\n \n\nThe response includes the recurringDetailReference that you must use in subsequent payments with a token:\n\n \n\nMake a payment with a token\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nstoredPaymentMethodId\n\nThe value returned in recurringDetailReference when the token was created.\n\n\nshopperInteraction\n\nSet to ContAuth.\n\n\nrecurringProcessingModel\n\nSet to Subscription.\n\n\n\n\n \n\nInstallments\nA shopper can split a payment across monthly installments.\nThe card issuer processes monthly installments:\n\nMaximum installments: 12 months\nMinimum amount: 50000 KRW. Requests below this threshold, even with installments.value set, is rejected.\n\nThe component does not render an installment selector. You must build and collect this in your own UI, then pass the value in the request.\n\n \n","type":"page","locale":"en","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Cards","lvl3":"KCP Direct Card Capture","lvl4":"KCP Direct Card Capture Web Component"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/payment-methods\/cards","lvl3":"https:\/\/docs.adyen.com\/payment-methods\/cards\/korean-cards-direct","lvl4":"\/payment-methods\/cards\/korean-cards-direct\/web-component"},"levels":5,"category":"Payment method","category_color":"green","tags":["Advanced flow","Component"]}],"articleFiles":{"payments-response.json":"
payments-response.json<\/p>"}}