Customer Blocklist

​

고객을 차단하면 발생하는 일

​

차단 대상 고객 매칭 방식

• 해당 이메일을 사용하는 모든 record가 적용 대상입니다. Checkout에서는 기존 이메일로 다시 방문한 고객에 대해 새 customer record를 만들 수 있으므로, 하나의 customer ID만 차단하면 우회할 수 있습니다. 이메일을 기준으로 차단하면 우회할 수 없습니다.
• Aliases도 적용 대상입니다. 이메일은 소문자로 비교하며 +alias가 제거됩니다. 따라서 buyer+promo@example.com와 Buyer@example.com는 동일한 고객으로 간주됩니다. 주소의 점은 입력된 그대로 유지됩니다.
• 귀사의 business에만 적용됩니다. 차단은 귀사의 business에만 적용됩니다. 동일한 이메일로도 Dodo Payments의 다른 business에서는 계속 구매할 수 있습니다.
• 이메일은 기존 고객에게 속해야 합니다. 귀사의 어떤 고객과도 일치하지 않는 이메일은 차단할 수 없으며, 이메일이 없는 customer record도 차단할 수 없습니다.

​

고객 차단하기

​

차단된 고객 관리

• Total Customers Blocked: 현재 차단된 고객 수입니다.
• Blocked entries: 차단당 하나의 행이 표시되며, 입력한 Identifier(email 또는 customer ID), Blocked By, Blocked On이 포함됩니다. Blocked By에는 차단을 추가한 팀원이 표시되며, API key로 추가된 차단은 API로 표시됩니다.
• Search Identifier 및 Filters: email 또는 customer ID로 항목을 검색하거나 Blocked By 및 Blocked Between으로 필터링할 수 있습니다.
• Action: See Details를 클릭하면 차단된 고객의 페이지가 열리고, Unblock을 클릭하면 차단이 해제됩니다. Viewer role의 팀원은 차단을 해제할 수 없습니다.

​

차단된 고객의 페이지

• 고객 이름 옆의 Blocked 배지 및 Unblock Customer 버튼
• Activity Log: 고객이 blocklist에 추가된 시점, 사유 및 이후 팀에서 추가한 notes입니다. Add Note를 클릭하여 chargeback 처리 결과와 같은 새로운 맥락을 기록할 수 있습니다. 나중에 API를 통해 note를 수정할 수 있습니다.
• Reference IDs: 이 차단에 연결된 customer ID이며, 복사할 수 있습니다.

​

고객 차단 해제하기

• Checkout 및 Customer Portal 변경 사항이 즉시 복원됩니다.
• 취소된 subscriptions는 다시 활성화되지 않습니다. 고객은 다시 구매해야 합니다.
• 항목은 notes와 함께 audit record로 보존되지만 활성 목록에는 더 이상 표시되지 않습니다.
• 나중에 같은 고객을 다시 차단할 수 있습니다. 이 경우 새 항목이 생성됩니다.

​

고객에게 표시되는 내용

• Checkout에서 결제가 일반적인 거부 메시지와 함께 실패합니다: “This payment cannot be processed.” API는 원인을 표시하지 않는 오류 코드 PAYMENT_NOT_PERMITTED와 함께 HTTP 403를 반환합니다. 실제 사유는 Dodo Payments의 logs에만 기록됩니다.
• Customer Portal에서 모든 항목이 표시되지만 계정을 변경하는 모든 action은 거부됩니다. 거부된 action은 PORTAL_ACTION_NOT_PERMITTED 및 “This action is not available.” 메시지와 함께 HTTP 403를 반환합니다. 포털 profile에는 read_only: true가 포함되므로 custom portal integration에서 자체 controls를 비활성화할 수 있습니다. 포털에는 blocklist 항목이나 notes가 절대 표시되지 않습니다.

​

API 사용

​

고객 차단하기

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
});

// Block by customer ID
const entry = await client.blocklist.customers.create({
  customer_id: 'cus_0NmichXWP8JYBB9Dw1Unj',
  reason: 'Chargeback on pay_0NmichXuYoNoapmr',
});

// Or block by email
const byEmail = await client.blocklist.customers.create({
  email: 'buyer@example.com',
  reason: 'Repeated refund abuse',
});

console.log(entry.id, entry.cancelled_subscription_ids);

import os
from dodopayments import DodoPayments

client = DodoPayments(bearer_token=os.environ["DODO_PAYMENTS_API_KEY"])

# Block by customer ID
entry = client.blocklist.customers.create(
    customer_id="cus_0NmichXWP8JYBB9Dw1Unj",
    reason="Chargeback on pay_0NmichXuYoNoapmr",
)

# Or block by email
by_email = client.blocklist.customers.create(
    email="buyer@example.com",
    reason="Repeated refund abuse",
)

print(entry.id, entry.cancelled_subscription_ids)

curl -X POST https://live.dodopayments.com/blocklist/customers \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_id": "cus_0NmichXWP8JYBB9Dw1Unj",
    "reason": "Chargeback on pay_0NmichXuYoNoapmr"
  }'

{
  "id": "bcu_7Hq2mV9kRt4LxYw3Pz",
  "customer_id": "cus_0NmichXWP8JYBB9Dw1Unj",
  "customer_name": "wow guy",
  "customer_email": "wowguy@example.com",
  "identifier": "cus_0NmichXWP8JYBB9Dw1Unj",
  "reason": "Chargeback on pay_0NmichXuYoNoapmr",
  "source": "api",
  "blocked_by_email": null,
  "created_at": "2026-09-02T12:09:41Z",
  "unblocked_at": null,
  "cancelled_subscription_ids": ["sub_3Fk8pW2nQs6MzXc1"],
  "subscriptions_swept": true
}

​

고객이 차단되었는지 확인

​

고객 차단 해제하기

await client.blocklist.customers.delete('bcu_7Hq2mV9kRt4LxYw3Pz');

client.blocklist.customers.delete("bcu_7Hq2mV9kRt4LxYw3Pz")

curl -X DELETE https://live.dodopayments.com/blocklist/customers/bcu_7Hq2mV9kRt4LxYw3Pz \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY"

​

모범 사례

• 사유를 기록하세요. 차단에 짧은 사유를 남기고 이후 발생하는 일은 notes로 기록하면 대시보드를 벗어나지 않고도 support team이 전체 상황을 파악할 수 있습니다.
• chargeback 후 차단하세요. dispute 또는 payment에서 고객 페이지를 열어 차단하거나, dispute.opened webhook의 POST /blocklist/customers를 사용하여 자동화하세요. Disputes를 참고하세요.
• subscriptions_swept를 확인하세요. API를 통해 차단할 때 response에 true가 표시될 때까지 call을 반복하여 live subscription이 남지 않도록 하세요.
• 환불은 별도로 처리하세요. 차단은 향후 구매만 중지합니다. 고객에게 지급해야 할 금액이 있다면 평소와 같이 payment를 환불하세요.
• 목록을 검토하세요. 문제가 해결된 고객은 차단을 해제하세요. 차단 해제는 즉시 적용되며 기록은 유지됩니다.

​

관련 문서