운영

1.1 요청 예시

결제 승인/취소 응답의 receiptUrl을 그대로 사용하거나, token 파라미터를 직접 전달하여 조회합니다.
별도의 파트너 인증(OAuth)이 필요하지 않습니다.

·주의사항

token은 결제 승인/취소 응답값의 receiptUrl에 포함된 암호화 토큰입니다.
언어 설정이 필요한 경우 lang 파라미터를 추가할 수 있습니다. (예: &lang=en)

1.2 receiptUrl 활용

결제 승인 또는 취소 성공 시 응답 데이터에 receiptUrl 필드가 포함됩니다.
해당 URL을 브라우저에서 바로 호출하면 매출전표를 확인할 수 있습니다.

· receiptUrl 응답 예시 : https://api.payple.kr/gpay/receipt?token=abc123...

2.1 파트너 인증 요청

POST 방식 조회 시 먼저 파트너 인증이 필요합니다. 발급된 토큰은 10분간 유효합니다.

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.2 매출전표 조회 요청

파트너 인증 후 발급받은 Access Token을 Header에 포함하여 요청합니다.

Header

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

Body

JSON

1{
2  "pay_id": "test_pay_id_123",
3  "lang": "kr"
4}

·주의사항

pay_id는 결제 성공 시 응답된 결제 고유 ID입니다.
lang은 선택 파라미터이며, kr(한국어, 기본값) 또는 en(영어)을 지원합니다.

3.1 응답 형식

매출전표 API는 JSON 응답이 아닌, HTML 페이지를 직접 반환합니다.
반환되는 매출전표에는 다음 정보가 포함됩니다.

상점 정보
- 상호명 (한국어/영어)
- 서비스명 (한국어/영어)
- 웹사이트
- 전화번호 / 이메일

결제 정보
- 거래 ID (pay_id)
- 결제 시간 (KST)
- 주문번호 (service_oid)
- 결제 금액 (통화 포함)
- 환불 금액 (환불 발생 시)
- 상품명
- 국가 (ISO)
- 구매자 이름 / 이메일
- 카드번호 (마스킹)
- 국제 브랜드사