목차

✅ 카드 번호 결제 API로 카드 번호 결제를 연동하세요. (서버 투 서버)

✅ 카드 번호 결제는 직접 카드 번호를 입력해서 결제하는 비인증 결제로 '수기 결제', '키인(Key-in) 결제'라고 불리기도 합니다.

카드 번호 결제 API는 추가 계약 후 사용할 수 있습니다. 추가 계약을 하고 싶다면 토스페이먼츠 고객센터(1544-7772, support@tosspayments.com)로 문의해주세요.

API 키 준비하기

API 개별 연동 키로 연동하세요.

토스페이먼츠에 회원가입하기 전이라면, 다음 문서 테스트 키로 연동할 수 있어요. 토스페이먼츠에 회원가입했다면, 로그인 후 다음 내 테스트 키로 결제를 연동하고 개발자센터에서 테스트 결제내역을 확인하세요.

// API 개별 테스트 연동 키
// 토스페이먼츠에 회원 가입하기 전이라면 아래 키는 문서 테스트 키입니다.
// 토스페이먼츠에 회원 가입하고 로그인한 상태라면 아래 키는 내 테스트 키입니다.
const clientKey = 'test_ck_D5GePWvyJnrK0W0k6q8gLzN97Eoq'
const secretKey = 'test_sk_zXLkKEypNArWmo50nX3lmeaxYG5R'
JavaScript

카드 번호 결제 API 요청 본문에는 다음과 같이 orderId, orderName, amount 등의 주문 정보와 cardNumber, cardExpirationMonth 등의 카드 정보가 포함되어야 합니다. 카드 번호와 카드 유효기간은 필수 파라미터입니다.

요청
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":"bbGlEy40QOjNfx352jiOz","orderName":"토스티셔츠 외 2건","customerName":"박토스","cardNumber":"4330123412341234","cardExpirationYear":"24","cardExpirationMonth":"07","cardPassword":"12","customerIdentityNumber":"881212"}'

토스페이먼츠와 계약할 때 비밀번호와 카드 소유자의 생년월일 필드를 필수 파라미터로 추가할 수 있는 옵션을 선택하면 해당 필드도 필수 파라미터가 됩니다. 계약할 때 선택한 옵션에 따라 필수 파라미터를 추가해주세요.

결제 승인에 성공하면 HTTP 200 OK와 Payment 객체를 받습니다. 응답에는 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,
"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

카드 번호 결제 API를 자세히 알아보세요

카드 번호 결제 API를 직접 실행해보세요

  • 더 궁금한 내용이 있나요?
  • 코드 샘플을 참고하세요
  • 기술지원이 필요한가요?
    디스코드 채팅|이메일 보내기