카드 번호 결제(키인 결제) 연동하기
카드 번호 결제 API를 이용하면 고객이 직접 카드 번호를 입력해서 결제할 수 있습니다.
카드 번호 결제는 직접 카드 번호를 입력해서 결제하는 비인증 결제로 '수기 결제', '키인(Key-in) 결제'라고 불리기도 합니다. 카드 결제 과정에서 카드사가 제공하는 인증 과정(ISP, 안심클릭)이 있으면 인증 결제입니다.
카드 번호 결제 API는 추가 계약 후 사용할 수 있습니다. 추가 계약을 하고 싶다면 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.
카드 번호 결제 API 사용하기
카드 번호 결제 API 요청 본문에는 주문 정보와 카드 번호가 포함되어야 합니다.
카드 번호와 카드 유효기간은 필수 파라미터입니다. 토스페이먼츠와 계약할 때 옵션으로 비밀번호, 카드 소유자의 생년월일 필드를 필수 파라미터로 추가할 수 있습니다.
요청
curl --request POST \
--url https://api.tosspayments.com/v1/payments/key-in \
--header 'Authorization: Basic dGVzdF9za196WExrS0V5cE5BcldtbzUwblgzbG1lYXhZRzVSOg==' \
--header 'Content-Type: application/json' \
--data '{"amount":15000,"orderId":"KNzDW3ClDmIxMImqE770A","orderName":"토스티셔츠 외 2건","customerName":"박토스","cardNumber":"4330123412341234","cardExpirationYear":"24","cardExpirationMonth":"07","cardPassword":"12","customerIdentityNumber":"881212"}'카드 결제 승인 응답에는 card 필드가 포함되어 있어야 합니다.
응답
{
"mId": "tosspayments",
"version": "2022-11-16",
"paymentKey": "",
"orderId": "",
"orderName": "토스티셔츠 외 2건",
"currency": "KRW",
"method": "카드",
"status": "DONE",
"transactionKey": "",
"lastTransactionKey": "",
"requestedAt": "2021-01-01T10:01:30+09:00",
"approvedAt": "2021-01-01T10:05:40+09:00",
"useEscrow": false,
"cultureExpense": false,
"card": {
"issuerCode": "61",
"acquirerCode": "31",
"number": "43301234****123*",
"installmentPlanMonths": 0,
"isInterestFree": false,
"interestPayer": null,
"approveNo": "00000000",
"useCardPoint": false,
"cardType": "신용",
"ownerType": "개인",
"acquireStatus": "READY"
},
"checkout": {
"url": "https://api.tosspayments.com/v1/payments//checkout"
},
"virtualAccount": null,
"transfer": null,
"mobilePhone": null,
"giftCertificate": null,
"foreignEasyPay": null,
"cashReceipt": null,
"cashReceipts": null,
"discount": null,
"cancels": null,
"secret": null,
"type": "NORMAL",
"easyPay": null,
"country": "KR",
"failure": null,
"totalAmount": 15000,
"balanceAmount": 15000,
"suppliedAmount": 13636,
"vat": 1364,
"taxFreeAmount": 0,
"taxExemptionAmount": 0
}
JSON