- Home
- PG 앱
- PG 앱 제작방법
- 정기결제 API 레퍼런스
- 정기결제 해지
정기결제 해지
등록된 정기결제 해지 처리하는 API에 대한 설명입니다.
중요정보
API URL은 개발자센터 APP PG 정보에서 관리됩니다.
정기결제 해지 호출 예시
- URL : 정기결제 해지 APP API URL
- 응답데이터 포맷 : JSON
정기결제 해지 호출 API URL
POST 정기결제 해지 APP API URL Content-Type: application/json Accept: application/json Accept-Charset: utf-8
요청코드 예시
curl -X POST '정기결제 해지 APP API URL' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Accept-Charset: utf-8' \
-d '{"key1":"value1", "key2":"value2"}' \
정기결제 해지 요청데이터 사양
| 파라미터 | 용도 | 데이터타입 | 필수 | 데이터 | 비고 |
|---|---|---|---|---|---|
| request_type | 처리 요청타입 | varchar(10) | 필수 | terminate(※고정값) | |
| partner_id | 가맹점ID | varchar(50) | 필수 | ||
| shop_no | 가맹점(멀티샵) 번호 | int | 권장 | ||
| paymethod | 결제수단 | varchar(10) | 필수 | 기본연동코드 - 결제수단 | |
| subscription_key | 정기결제 키 | varchar(20) | 필수 | ||
| buyer_id | 주문자 ID | string(20) | 필수 | ||
| order_id | 가맹점 주문번호 | varchar(30) | 권장 | ||
| hash_data | 위∙변조 방지 암호화데이터 | text | 필수 | 형식) base64_encode(hash_hmac('sha256', 평문, service_key, true)) ㆍ평문 (파라미터명 오름차순으로 나열) ㆍpartner_id : 가맹점 ID ㆍbuyer_id : 주문자 ID ㆍsubscription_key : 정기결제 키 ㆍservice_key : 앱 생성시 개발자센터에서 발급받은 Service_key ex) base64_encode(hash_hmac('sha256', 'partner_id+buyer_id+subscription_key', service_key, true)) |
|
| extra_data | 결제 확장 데이터 | text(json) | 필수 | 가공하지 않고 받은 그대로 전달하는 필드 |
정기결제 해지 응답데이터 사양
| 파라미터 | 용도 | 데이터타입 | 필수 | 데이터 | 비고 |
|---|---|---|---|---|---|
| result_code | 응답코드 | char(4) | 필수 | '0000' 이외에는 모두 실패 | |
| result_message | 응답메세지 | text | 필수 | 응답코드에 따른 응답메시지 전문 ㆍ메세지 조합 ㆍ성공시 : 성공 ㆍ실패시 : 앱 메세지 - [PG사 리턴코드] PG사 메세지 |
다음 문서
이 페이지가 얼마나 도움이 되었나요?
0자 입력 /최대 300자