로고Developer Center

운영

해외 카드빌링키 차단


연동하기

비정상 거래 의심 시 또는 결제를 임시 중단할 필요가 있는 경우, 빌링키를 일시적으로 차단/해제할 수 있습니다.
매 결제 시 파트너 인증이 필요하며, 이때 발급된 토큰은 10분간 유효합니다.

연동 흐름

빌링키차단(해제) 요청
빌링키차단(해제) 요청

1. 파트너 인증 요청

Server
파라미터 확인 →

1.1 요청 예시

Header 설정 후 API를 요청해주세요.

POSThttps://demo-api.payple.kr/gpay/oauth/1.0/token테스트 환경
POSThttps://api.payple.kr/gpay/oauth/1.0/token라이브 환경
Header
1Content-Type: application/json
2Cache-Control: no-cache
Body
JSON
1{
2  "service_id": "demo",
3  "service_key": "abcd1234567890",
4  "code": "as12345678"
5}

·주의사항

code는 파트너 인증에 필요한 토큰을 확인하는 용도로 사용되며, 파트너(상점)가 직접 생성하여 전송해야 하는 중요한 요소입니다.
영문+숫자 조합 10자리로 구성되어야 합니다.

2. 빌링키 차단/해제 요청

Server
파라미터 확인 →

2.1 요청 예시

Header 설정 후 API를 요청해주세요.

POSThttps://demo-api.payple.kr/gpay/billingkey/block빌링키 차단 테스트 환경 환경
POST https://api.payple.kr/gpay/billingkey/block빌링키 차단 라이브 환경 환경
POSThttps://demo-api.payple.kr/gpay/billingkey/unblock빌링키 해제 테스트 환경 환경
POSThttps://api.payple.kr/gpay/billingkey/unblock빌링키 해제 라이브 환경 환경
Header
1Authorization : 'Bearer ' + {파트너 인증 후 응답된 access_token}
2Content-Type : application/json
3Cache-Contro : no-cache
Body
JSON
1{
2  "service_id": "demo",
3  "billing_key": "MlNCQ0pHMn…"
4}