카드 빌링키 발급하기

고객이 결제창에 카드 정보를 등록하여 빌링키를 발급받아요. 발급받은 빌링키는 데이터베이스에 저장하고, 결제 요청 시 해당 빌링키를 사용해요.

프론트엔드에서 발급하기
프론트엔드에서 발급하기
PG사 결제창을 통해 안전하게 발급
백엔드에서 발급하기
백엔드에서 발급하기
가맹점이 직접 카드 정보를 수집
1
전체 흐름
Client

PG 결제창에 카드 정보를 입력하고 인증을 거치면 빌링키가 발급됩니다. 보안상 빌링키는 바로 프론트엔드로 전달되지 않으므로, 서버에서빌링키를 조회한 후 저장해야 합니다.

지원 PG사:KCP,다날,이니시스,나이스페이먼츠,토스페이먼츠,웰컴페이먼츠,키움페이
2
빌링키 발급 요청
Client

Bootpay.requestSubscription 함수를 사용하여 빌링키 발급을 위한 결제창을 띄웁니다.

  • payload.subscription_id가맹점에서 관리하는 고유 주문번호
  • payload.method카드자동 값을 지정
  • payload.price0보다 큰 값이면 빌링키 발급 즉시 결제, 0이면 빌링키만 발급
  • extra.subscribe_test_paymenttrue 지정 시 100원 테스트 결제 후 취소
3
발급 결과 처리
Client

빌링키 발급이 완료되면 done 이벤트를 전달받습니다. 이벤트 처리에 대한 자세한 내용은결제 이벤트 처리를 참고하세요.

4
빌링키 조회 및 저장
Server

보안상 빌링키는 클라이언트로 바로 전달되지 않습니다. 서버에서빌링키 조회 API를 호출하여 빌링키를 확인하고 데이터베이스에 저장하세요.

프론트엔드
빌링키 발급 (클라이언트)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77