API 키 준비하기

카드 번호 결제(키인 결제) API로 연동하기

✅ 카드 번호 결제 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를 직접 실행해보세요