결제 세션 조회

결제 페이지가 화면을 렌더링하는 데 필요한 정보를 공개 토큰으로 조회합니다.

GEThttps://pay.apiacc.com/pay/{token}

인증이 필요 없는 공개 API입니다. 결제 상태, 사용 가능한 결제 수단, 수수료율 등을 반환합니다.

인증 불필요

이 엔드포인트는 checkout_url에 포함된 공개 토큰만으로 동작하며 Authorization 헤더가 필요 없습니다. 브라우저에서 직접 호출해도 안전합니다.

경로 파라미터

필드	타입	필수	제한	예시
`token` 결제 생성 응답의 checkout_url에 포함된 공개 토큰입니다.	string	필수	—	"pub_xxx"

curl -X GET "https://pay.apiacc.com/pay/pub_xxx" \
  --max-time 10

응답

200결제 세션 정보

{
  "payment": {
    "id": "pay_xxx",
    "ref": "order_1234",
    "name": "홍길동",
    "content": "게임 캐시 충전",
    "amount": 10000,
    "status": "pending",
    "method": null,
    "expires_at": "2026-08-15T12:10:00Z"
  },
  "payment_methods": [
    "bank_transfer",
    "cultureland_pin"
  ],
  "fee_percent": 0,
  "pin_charges": [],
  "bank": null
}

bank_transfer 결제 수단이 이미 선택된 세션을 조회하면 bank 필드에 입금 계좌 정보가 채워집니다. pin_charges는 지금까지 제출된 PIN 처리 결과 목록입니다.

계좌이체 선택 후 조회 예시

{
  "payment": {
    "id": "pay_xxx",
    "status": "processing",
    "method": "bank_transfer"
  },
  "payment_methods": [
    "bank_transfer",
    "cultureland_pin"
  ],
  "fee_percent": 0,
  "pin_charges": [],
  "bank": {
    "bank_name": "국민은행",
    "bank_account": "123456-04-987654",
    "account_holder": "김판매",
    "depositor": "홍길동"
  }
}

주요 오류

상태	error
404	payment_not_found
429	rate_limit_exceeded

이전결제 생성 다음계좌이체 결제