Billing Webhooks

Receive Webhook

PG 웹훅 수신 - 받은 뒤 7단계로 처리한다.

post/v1/billing/webhooks/{provider}

Request

  • Base URL: https://api.xdata.kr (the document declares no server; this is the origin it was published from)
  • URL: https://api.xdata.kr/v1/billing/webhooks/{provider}
  • Auth: one of:
    • HTTP basic
    • OAuth 2 (authorization code, authorization URL https://api.xdata.kr/oauth/authorize, token URL https://api.xdata.kr/oauth/token)

Path parameters

providerstring required

Headers

X-Env-Scope'sandbox' | 'real_test' | 'production' nullable

외부 PG 가 보내는 환경 힌트입니다(필수가 아닙니다). 값은 production, real_test, sandbox 중 하나이고, 보내면 그 환경의 서명만 검증합니다. 보내지 않으면 production, real_test, sandbox 순서로 시도해 서명이 맞는 환경을 고릅니다. 목록 밖의 값은 HTTP 400 WEBHOOK_PAYLOAD_INVALID 로 거절합니다.

Response

Successful Response

receivedtrue required

수신 확인. 잠금된 단일 값(true). PG 사업자 호환 보존 위해 변경 금지. false 반환 케이스는 정의되지 않으며, 영구 오류도 received=true + 내부 FAILED 분류.

Changes

No recorded changes to this operation across all 1 revision of this API.