웹후크 예약(온디맨드 재고)

COMPLEX 목록에 대한 필드 값을 반환하는 HTTPS 엔드포인트를 구성하세요. 호출이 실패해도 결제는 완료되며, 수동으로 재시도하거나 이행할 수 있습니다.

구매자가 결제할 때 라이센스, 계정 또는 키 값을 서버에서 가져옵니다.

웹후크 예약을 사용할 때

구매 시 귀하의 시스템에서 키나 계정을 생성할 때 COMPLEX(고유 단위) 재고에 대해 사용하세요. 로컬 재고가 항상 선호되며, 웹후크는 단지 부족한 부분만 채웁니다.

  • 모든 단위가 실제로 할당된 경우에만 INSTANT 자동 배송과 함께 작동합니다.
  • 제공 수준 기본값을 구성하거나 가격 옵션별로 재정의하세요.
  • HTTPS만 사용하세요. 선택적 HMAC 서명은 아웃바운드 웹후크와 일치합니다.

결제 안전 실패

귀하의 엔드포인트가 시간 초과되거나 잘못된 데이터를 반환하는 경우, 주문은 PAID 상태로 유지됩니다. 구매자는 요금을 청구받으며, 귀하는 주문에서 오류를 보고하고 예약을 재시도하거나 수동으로 키를 연결할 수 있습니다.

계약 요청

결제 후, RMT는 주문, 제공, 옵션, 필드 스키마 및 수량 1과 함께 누락된 단위당 하나의 reserve.item 호출을 POST합니다. 선택적 요청 템플릿 JSON은 {{placeholders}}와 병합됩니다.

정규 POST 본문(생략됨)

json
{
  "id": "rsv_…",
  "type": "reserve.item",
  "order": { "uid": "…", "reference": "…", "url": "…" },
  "offer": { "url": "…", "title": "…", "pageUrl": "…" },
  "option": { "id": 1, "name": "Standard" },
  "fields": [{ "id": 10, "name": "License", "type": "text", "required": true }],
  "quantity": 1
}

응답 및 필드 매핑

2xx JSON을 반환하세요. $.license와 같은 경로를 항목 필드에 매핑하거나, { "entries": [{ "fieldId": 10, "value": "KEY-…" }] }를 반환하세요.

편리한 응답

json
{
  "entries": [
    { "name": "License", "value": "AAAA-BBBB-CCCC" }
  ]
}
  • 라이센스 전용: $.license 또는 $.key에서 하나의 텍스트 필드를 매핑하세요.
  • 계정: $.email 및 $.password에서 이메일 및 비밀번호 필드를 매핑하세요.
  • 매핑 후 필수 필드가 누락되면 실패로 간주됩니다.

테스트, 재시도 및 보안

제공 편집기에서 테스트를 사용하세요(드라이런: true를 전송). 주문 페이지에서 엔드포인트를 수정한 후 예약을 재시도하세요. 이메일에 비밀이나 전체 키를 기록하지 마세요.

  1. 1제공 항목 단계에서 HTTPS URL, 응답 매핑 및 선택적 비밀을 저장하세요.
  2. 2테스트를 실행하고 매핑된 미리보기를 확인하세요.
  3. 3실패 시 주문을 열고 예약을 재시도하거나 수동으로 키를 생성/지정하세요.

결제 전에 예약 호출하지 마세요

RMT는 결제가 성공적으로 이루어진 후에만 귀하의 엔드포인트를 호출하므로, 포기된 결제는 라이센스를 소모하지 않습니다.