Versions Compared

Version Old Version 17 New Version Current
Changes made by

송훈일Neil

송훈일Neil

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

1) Purpose

  • 채널에서 구매자에 의해 발생한 주문에 대한 주문 취소 건에 대한 환불을 AX Cloud 에 요청합니다.

  • 채널에서 미리 정해진 환불 규정에 따라 AX Cloud로 단방향 요청을 합니다.

...

Endpoint

product environment: https://prod.ax-cloud.com/v1/channel/orders/tour/{ax_order_code}/tickets/{ticket_code}/refundsrefund

Method

POST

Description

채널에서 특정 주문의 환불이 진행된 건에 대해 AX Cloud와 동기화 합니다.

Content-Type

application/json

Headers > Authorization

Token {api_key}

...

Name

Required

Type

Description

refundchannel_refunded_price

O

String

  • 채널에서 구매자에게 환불해준 가격

channel_canceled_datetimeat

O

Datetime

  • 채널에서 주문의 취소가 발생한 일시

channel_refunded_datetimeat

O

Datetime

  • 채널에서 구매자에게 환불이 완료된 일시

channel_policy

O

Object

  • 채널의 환불 규정

  • 예시

    • {"0": “1", # Use date 1일 전부터는 환불 불가
      "50": "3", # Use date 3일 전부터는 50% 환불
      "100": “7"} # Use date 7일 전부터는 100% 환불

...

Expand
titleStatus Code : 403 Cause: 유효하지 않은 API Key 혹은 Channel Code
Code Block
{'messagedetail': '이 작업을 수행할 권한(permission)이 없습니다.'}
Expand
titleStatus Code : 404 Cause: 유효하지 않은 order_code, ticket_code
Code Block
{'messagedetail': '찾을 수 없습니다.'}

3. Request Example

...

Code Block
curl -X 'PATCH' \
  'https://prod.ax-cloud.com/v1/channel/orders/tour/b9872ed4-12c5-4fb5-ae18-4f39b11ee912/tickets/915c1218-f41c-492b-bb0b-96177ff4d2ee/refunds' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Token api_key_secret" \
  -d '{ \
  "refund_price": "5000",
  "channel_canceled_datetime": "2021-01-20 21:13:13",
  "channel_refunded_datetime": "2021-01-20 23:24:29",
  "policy": {"0": "1", "50": "3",  "100": “7"}
}'

...