Skip to main content
각 규칙은 비율, 적용 기간, 선택적 가맹점 필터를 설정하며, 하나의 하위 계정으로 제한할 수 있습니다. Cashback Rules API를 사용하여 플랫폼이 자금을 부담하는 규칙을 생성, 업데이트, 조회하고, 사용 가능한 USD 잔액에서 필요할 때 캐시백을 지급할 수 있습니다.

엔드포인트

캐시백 지급

지급 가능한 모든 캐시백을 분배하려면 POST /cashback_rules/payout에 빈 객체를 보내세요. 하나의 규칙만 분배하려면 cashback_rule_id를, 하나의 하위 계정에 지급하려면 account_id를, 하나의 카드 거래에 지급하려면 transaction_id를 설정하세요. 여러 필터를 지정하면 모두 일치해야 합니다.
지급을 요청할 때는 Idempotency-Key 헤더를 사용하세요. status: "processing"이 포함된 202 응답은 처리가 대기열에 추가되었음을 확인하며 제공된 필터를 그대로 반환합니다. status: "failed"가 포함된 200 응답은 대기열이 요청을 거부했음을 의미합니다. 이 상태는 지급 완료가 아니라 예약 상태를 나타냅니다. 거래 작업은 실패 시 자동으로 재시도됩니다. 자금 지갑의 잔액이 부족하면 USD를 추가하세요. 반복 요청은 이미 기록된 지급을 건너뛰며, 원장 멱등성이 중복 입금을 방지합니다. 응답:

속성

string
필수
캐시백 규칙 ID이며, 접두사는 cicbr_입니다.
string
필수
규칙이 생성된 시점으로, ISO 8601 타임스탬프입니다.
string | null
필수
캐시백 규칙에 대한 선택적 설명입니다.
string | null
필수
규칙이 폐기된 시점으로, ISO 8601 타임스탬프입니다. Null이면 폐기되지 않았음을 의미합니다.
string | null
필수
적용 기간의 종료 시점(해당 시점 미포함)으로, ISO 8601 타임스탬프입니다. Null이면 만료되지 않음을 의미합니다.
string
필수
캐시백 자금을 부담하도록 지정된 플랫폼 계정으로, 접두사는 biz_입니다. 인증된 자격 증명에서 파생됩니다.
string | null
필수
네 자리 가맹점 업종 코드입니다. Null이면 모든 MCC와 일치합니다. 두 가맹점 필터가 모두 null이면 scoped_account_id가 필수입니다.
string | null
필수
카드 제공업체가 보고한 원래 가맹점 이름입니다. Null이면 모든 가맹점 이름과 일치합니다. 설정하면 MCC 필터와 함께 일치 여부를 판단하며, 부분 문자열이나 보강된 표시 이름으로 일치시키지 않습니다.
integer
필수
베이시스 포인트 단위의 캐시백 비율입니다. 100은 1%, 10000은 100%를 의미합니다.
string | null
필수
하위 계정 ID이며, 접두사는 biz_입니다. Null이면 자금 제공 플랫폼의 모든 직속 하위 계정을 지정합니다.
string
필수
규칙 적용 기간의 시작 시점(해당 시점 포함)으로, ISO 8601 타임스탬프입니다.
string
필수
규칙이 마지막으로 업데이트된 시점으로, ISO 8601 타임스탬프입니다.
CashbackRule