Versions Compared

Key

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

...

파라미터명

타입

설명

transaction_id

string

포인트 지급/차감에 발급되는 ID입니다. 포인트 중복 지급/차감을 방지하기 위해 사용합니다. 같은 transaction_id로 요청이 온 경우에는 반드시 포인트 중복 적립/차감이 되지 않도록 처리해야 합니다.

user_id

string

파트너사에서 정의한 유저의 식별값입니다.

points

array

적립/차감 해야되는 포인트 금액 배열 입니다. 여러 리워드가 동시발생하여 지급/차감될 수 있습니다.

custom

object

적립 요청에는 유저가 참여한 캠페인 ID와 이름, 차감 요청에는 차감 사유가 포함됩니다.

JSON복사

Code Block
{
    "transaction_id": "2195ffb0-8f64-44b2-8c85-4723b9ecb18a",
    "user_id": "USER_123456789",
    "points": [
				{
						"point": 10,
						"custom": {
								"campaign_id": "1234-567890-abcd-efgh"
								"campaign_name": "대시보드에서 설정한 캠페인 이름"
						}
				},
				{
						"point": -1500,
						"custom": {
								"reason": "네이버페이 포인트 전환"
						}
				},
    ],
}

...

파라미터명

타입

설명

transaction_id

string

포인트 지급/차감에 발급되는 ID입니다. 포인트 중복 지급/차감을 방지하기 위해 사용합니다. 같은 transaction_id로 요청이 온 경우에는 반드시 포인트 중복 적립/차감이 되지 않도록 처리해야 합니다.

user_id

string

파트너사에서 정의한 유저의 식별값입니다.

coupon

object

지급해야하는 쿠폰 객체입니다.

coupon.code

string

지급해야하는 쿠폰 코드로 쿠폰의 식별자입니다. 최대 250자까지 지원합니다.(ascii)

amount

integer

지급해야하는 쿠폰의 수량입니다.

JSON복사

Code Block
{
    "transaction_id": "2195ffb0-8f64-44b2-8c85-4723b9ecb18a",
    "user_id": "USER_123456789",
    "coupon": {
      "code": "ABC123",
    },
    "amount": 2
}

...