자동 지급 API

블리피 프로모션 내 기프트 또는 리워드 지급 대상자를 자동으로 처리하기 위한 API 안내 문서입니다. 해당 API는 지급 대상자인 유저키 정보와 지급 품목 등에 대한 정보를 콜백으로 전달합니다. 등록 방법은 API 설정 페이지를 참고하세요.

프로모션 내에 직접 지급 해야하는 실물 리워드(ex. 자사 쿠폰, 자사 포인트, 배송 상품, 기타)를 설정한 경우, 기프트/리워드 코드가 발급됩니다. 클라이언트는 콜백으로 전달된 해당 코드를 기반으로 실물 리워드 처리를 진행할 수 있습니다. 전송 결과에 따라 블리피 시스템 내에서는 기프트/리워드 지급 처리가 완료됩니다.

기프트/리워드 코드 확인 방법
- [Client Admin] 로그인 > 프로모션 상세 페이지 > [개발 정보 확인하기] 팝업 내에서 확인

해당 API는 블리피 서버 -> 클라이언트 서버로 요청됩니다.

Request

Method

URL

POST

API 사용 관리 페이지에 등록한 클라이언트별 [자동 지급 API] 주소

Body

// Body Example
list: [ 
  {
    code: "AD3FYTFS", 
    userKey: "2eew35da" 
  }
]

Name

Type

Description

list

ArrayList<AutoPayment>

code, userKey를 전달

AutoPayment

Name

Type

Description

code

String

프로모션에 등록된 기프트/리워드 연동 코드

userKey

String

지급 대상 userKey

Response

요청 처리 정상

HTTP status code

200

참고사항

자동 지급 처리 시 콜백은 list size가 항상 1로 전달 됩니다.

지급 처리에 실패해, 지급 처리 메뉴에서 수동으로 재시도 하는 경우 Max 50개까지 전달됩니다.

(ex. 70건 지급 처리 재시도 시, 50건 / 20건으로 2번에 걸쳐 전송)

개발에 대한 추가 설명이 더 필요하신가요?

"[Client Admin] 로그인 → 오른쪽 하단 채널톡 위젯" 클릭 후 개발 카테고리에 문의 남겨주시면 기술 개발팀에서 확인 후 연락드리겠습니다.

Last updated 2 months ago