PIN2P - 판매자 지원 API

Seller API 판매자 지원 API

제공 API

5종

인증 방식

API KEY

응답 형식

JSON

이용 대상

승인 판매자

아래 API는 PIN2P 판매자 심사를 통과한 승인 판매자에게만 제공됩니다. 미승인 계정의 API 호출은 403 Forbidden으로 처리됩니다. 판매자 등록 후 고객센터를 통해 API 키를 신청해 주세요.

API 키 발급 및 관리

API 키는 고객센터 문의를 통해 발급 신청이 가능합니다.

발급 키 형식

pk2p_live_●●●●●●●●●●●●●●●●●●●●

고객센터 신청

발급된 키는 모든 API 요청 헤더에 X-PIN2P-API-KEY: <발급키> 형태로 포함하여 사용하세요. 키는 외부에 노출되지 않도록 서버 사이드에서 관리하시기 바랍니다.

제공 API 목록

총 5개

API 이름 / 설명 메서드 엔드포인트 상세 보기

상품권 실시간 시세 조회

브랜드별 매입가·매도가·거래량 실시간 조회

GET

/v1/price/list

GET https://api.pin2p.com/v1/price/list

요청 파라미터

파라미터	타입	설명
`brand`optional	string	브랜드 코드 (미입력 시 전체)
`amount`optional	integer	권종 금액 (예: `50000`)

응답 예시

{ "status": "ok", "data": [{ "brand": "cultureland", "amount": 50000, "buy_rate": 93.5, "sell_rate": 95.0 }] }

상품권 거래 등록

판매자 시스템에서 매도 거래 자동 등록

POST

/v1/trade/create

POST https://api.pin2p.com/v1/trade/create

요청 파라미터 (JSON Body)

파라미터	타입	설명
`brand`필수	string	브랜드 코드
`pin_numbers`필수	array	상품권 번호 배열 (최대 100개)
`amount`필수	integer	권종 금액 (원)
`sell_rate`optional	float	희망 매도율 (%). 미입력 시 시세 자동 적용

응답 예시

{ "status": "ok", "trade_id": "TRD-20260425-0321", "count": 10, "face_val": 500000, "payout": 475000, "rate": 95.0 }

거래 내역 조회

등록 거래 목록 및 처리 상태 페이지 단위 조회

GET

/v1/trade/list

GET https://api.pin2p.com/v1/trade/list

요청 파라미터

파라미터	타입	설명
`status`optional	string	`pending` / `completed` / `cancelled`
`date_from`optional	string	조회 시작일 (YYYY-MM-DD)
`date_to`optional	string	조회 종료일 (YYYY-MM-DD)
`page`optional	integer	페이지 번호 (기본값: `1`)

응답 예시

{ "status": "ok", "total": 58, "page": 1, "data": [{ "trade_id": "TRD-20260425-0321", "payout": 475000, "status": "completed" }] }

정산 내역 조회

완료 거래 정산 금액 및 입금 상태 조회

GET

/v1/settlement/list

GET https://api.pin2p.com/v1/settlement/list

요청 파라미터

파라미터	타입	설명
`month`optional	string	정산 월 (YYYY-MM). 미입력 시 당월

응답 예시

{ "status": "ok", "month": "2026-04", "total": 4750000, "settled": 4200000, "pending": 550000 }

상품권 유효성 검증

잔액 및 사용 가능 여부 사전 검증

POST

/v1/pin/validate

POST https://api.pin2p.com/v1/pin/validate

요청 파라미터 (JSON Body)

파라미터	타입	설명
`brand`필수	string	브랜드 코드
`pin_number`필수	string	검증할 상품권 번호

응답 예시

{ "status": "ok", "is_valid": true, "balance": 50000, "is_used": false, "expires_at": "2027-04-25" }

API 연동을 시작하세요

판매자 심사 완료 후 고객센터를 통해 API 키를 신청하면 24시간 내로 발급 안내를 받으실 수 있습니다.

API 키 신청하기 판매자 등록하기