결제 (Purchase)

결제 관련 사용자 행동 수집 API

사용자 행동수집 - 결제취소

post

/actions/purchase/cancel

결제취소 수집 API

Header parameters

Content-Typestring · enumRequired

컨텐츠 타입

Possible values:

Idempotency-Keystring · uuidRequired

멱등성 키 - 클라이언트가 호출시 전달해야 함 (UUID)

serviceKeystringRequired

서비스키

requestIdstringRequired

리퀘스트 아이디

Body

사용자가 결제를 취소하는 행동을 전송

specversionstring · enumOptional

스펙 버전

Possible values:

idstring · enumOptional

이벤트 고유 식별자

Possible values:

typestring · enumOptional

이벤트 유형

Possible values:

timestring · date-timeRequired

ISO 8601 UTC 이벤트 생성시간

sourcestringRequired

이벤트 발생 출처

datacontenttypestring · enumOptional

데이터 컨텐츠 타입

Possible values:

dataschemastring · enumOptional

데이터 스키마 경로

Possible values:

Responses

200

수집 성공

No content

400

잘못된 요청

503

서비스 일시 불가

post/actions/purchase/cancel

POST /actions/purchase/cancel HTTP/1.1
Host: statistics.genser.app
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
serviceKey: text
requestId: text
Content-Type: application/json
Accept: */*
Content-Length: 829

{
  "specversion": "1.0",
  "id": "EVT-CANCEL-PURCHASE",
  "type": "cancel_purchase",
  "time": "2025-12-02T10:00:00Z",
  "source": "https://shop.groobee.com",
  "data": {
    "@context": "https://schema.org/",
    "@type": "CancelAction",
    "agent": {
      "@type": "Person",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "memberId",
          "value": "groobee1234"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "userId",
          "value": "2aa9a562-4182-4c59-b886-2be9d2a36b23"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "cookieId",
          "value": "bb404573-c87f-b4b1-d6e7-f2750499bf06"
        }
      ]
    },
    "object": {
      "@type": "OrderItem",
      "orderedItem": {
        "@type": "Product",
        "sku": "NIKE_0000001",
        "name": [
          {
            "@value": "나이키 에어조던",
            "@language": "ko"
          }
        ],
        "offers": {
          "@type": "Offer",
          "price": 150000,
          "priceCurrency": "KRW"
        }
      },
      "orderQuantity": 1
    },
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://shop.groobee.com/purchase/cancel"
    }
  }
}

No content

사용자 행동수집 - 결제시작

post

/actions/purchase/checkout

결제시작 수집 API

Header parameters

Content-Typestring · enumRequired

컨텐츠 타입

Possible values:

Idempotency-Keystring · uuidRequired

멱등성 키 - 클라이언트가 호출시 전달해야 함 (UUID)

serviceKeystringRequired

서비스키

requestIdstringRequired

리퀘스트 아이디

Body

사용자가 결제를 시작하는 행동을 전송

specversionstring · enumOptional

스펙 버전

Possible values:

idstring · enumOptional

이벤트 고유 식별자

Possible values:

typestring · enumOptional

이벤트 유형

Possible values:

timestring · date-timeRequired

ISO 8601 UTC 이벤트 생성시간

sourcestringRequired

이벤트 발생 출처

datacontenttypestring · enumOptional

데이터 컨텐츠 타입

Possible values:

dataschemastring · enumOptional

데이터 스키마 경로

Possible values:

Responses

200

수집 성공

No content

400

잘못된 요청

503

서비스 일시 불가

post/actions/purchase/checkout

POST /actions/purchase/checkout HTTP/1.1
Host: statistics.genser.app
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
serviceKey: text
requestId: text
Content-Type: application/json
Accept: */*
Content-Length: 831

{
  "specversion": "1.0",
  "id": "EVT-START-CHECKOUT",
  "type": "start_checkout",
  "time": "2025-12-02T10:00:00Z",
  "source": "https://shop.groobee.com",
  "data": {
    "@context": "https://schema.org/",
    "@type": "CheckoutAction",
    "agent": {
      "@type": "Person",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "memberId",
          "value": "groobee1234"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "userId",
          "value": "2aa9a562-4182-4c59-b886-2be9d2a36b23"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "cookieId",
          "value": "bb404573-c87f-b4b1-d6e7-f2750499bf06"
        }
      ]
    },
    "object": {
      "@type": "OrderItem",
      "orderedItem": {
        "@type": "Product",
        "sku": "NIKE_0000001",
        "name": [
          {
            "@value": "나이키 에어조던",
            "@language": "ko"
          }
        ],
        "offers": {
          "@type": "Offer",
          "price": 150000,
          "priceCurrency": "KRW"
        }
      },
      "orderQuantity": 1
    },
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://shop.groobee.com/purchase/checkout"
    }
  }
}

No content

사용자 행동수집 - 결제완료

post

/actions/purchase/complete

결제완료 수집 API

Header parameters

Content-Typestring · enumRequired

컨텐츠 타입

Possible values:

Idempotency-Keystring · uuidRequired

멱등성 키 - 클라이언트가 호출시 전달해야 함 (UUID)

serviceKeystringRequired

서비스키

requestIdstringRequired

리퀘스트 아이디

Body

사용자가 결제를 완료하는 행동을 전송

specversionstring · enumOptional

스펙 버전

Possible values:

idstring · enumOptional

이벤트 고유 식별자

Possible values:

typestring · enumOptional

이벤트 유형

Possible values:

timestring · date-timeRequired

ISO 8601 UTC 이벤트 생성시간

sourcestringRequired

이벤트 발생 출처

datacontenttypestring · enumOptional

데이터 컨텐츠 타입

Possible values:

dataschemastring · enumOptional

데이터 스키마 경로

Possible values:

Responses

200

수집 성공

No content

400

잘못된 요청

503

서비스 일시 불가

post/actions/purchase/complete

POST /actions/purchase/complete HTTP/1.1
Host: statistics.genser.app
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
serviceKey: text
requestId: text
Content-Type: application/json
Accept: */*
Content-Length: 834

{
  "specversion": "1.0",
  "id": "EVT-COMPLATE-PURCHASE",
  "type": "complate_purchase",
  "time": "2025-12-02T10:00:00Z",
  "source": "https://shop.groobee.com",
  "data": {
    "@context": "https://schema.org/",
    "@type": "OrderAction",
    "agent": {
      "@type": "Person",
      "identifier": [
        {
          "@type": "PropertyValue",
          "propertyID": "memberId",
          "value": "groobee1234"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "userId",
          "value": "2aa9a562-4182-4c59-b886-2be9d2a36b23"
        },
        {
          "@type": "PropertyValue",
          "propertyID": "cookieId",
          "value": "bb404573-c87f-b4b1-d6e7-f2750499bf06"
        }
      ]
    },
    "object": {
      "@type": "OrderItem",
      "orderedItem": {
        "@type": "Product",
        "sku": "NIKE_0000001",
        "name": [
          {
            "@value": "나이키 에어조던",
            "@language": "ko"
          }
        ],
        "offers": {
          "@type": "Offer",
          "price": 150000,
          "priceCurrency": "KRW"
        }
      },
      "orderQuantity": 1
    },
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "https://shop.groobee.com/purchase/complate"
    }
  }
}

No content