운영

해외 카드〉취소

연동하기

승인 완료된 결제를 취소할 수 있습니다.
매 결제 시 파트너 인증이 필요하며, 이때 발급된 토큰은 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/cancel테스트 환경

POSThttps://api.payple.kr/gpay/cancel라이브 환경

Header

1Authorization : 'Bearer ' + {파트너 인증 후 응답된 access_token}
2Content-Type : application/json
3Cache-Contro : no-cache

Body

JSON

1{
2  "service_id": "demo",
3  "comments": "테스트 상품",
4  "service_oid": "order12345",
5  "pay_id": "6548264741426583803027",
6  "totalAmount": "0.10",
7  "currency": "USD"
8}