Customer Blocklist

​

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

​

고객 차단 매칭 방식

• 해당 이메일의 모든 record에 적용됩니다. Checkout에서는 재방문 이메일에 대해 새로운 customer record를 생성할 수 있으므로, 단일 customer ID에 대한 차단은 우회될 수 있습니다. 이메일을 차단하면 우회할 수 없습니다.
• 별칭에도 적용됩니다. 이메일은 소문자로 비교하며 +alias를 제거합니다. 따라서 buyer+promo@example.com와 Buyer@example.com는 동일한 고객으로 처리됩니다. 주소의 점은 그대로 유지됩니다.
• 비즈니스별로 적용됩니다. 차단은 해당 비즈니스에만 적용됩니다. 동일한 이메일은 Dodo Payments의 다른 비즈니스에서 계속 구매할 수 있습니다.
• 이메일은 기존 고객에 속해야 합니다. 귀하와 checkout을 진행한 적이 없는 이메일은 차단할 수 없으며, 이메일이 없는 customer record도 차단할 수 없습니다.

​

고객 차단

​

차단된 고객 관리

• Total Customers Blocked: 현재 차단된 고객 수입니다.
• Blocked entries: 차단 항목당 한 행으로 표시되며, 입력한 Identifier(email 또는 customer ID), Blocked By(차단을 추가한 팀원), Blocked On이 포함됩니다.
• Search Identifier 및 Filters: 이메일 또는 customer ID로 항목을 찾거나, 차단한 사람과 시점으로 필터링할 수 있습니다.
• Action: 고객 차단 해제를 포함하여 항목을 관리합니다.

​

차단된 고객의 페이지

• 고객 이름 옆의 Blocked 배지와 Unblock Customer 버튼
• Activity Log: 고객이 차단 목록에 추가된 시점, 이유, 이후 팀에서 추가한 메모가 표시됩니다. Add Note를 클릭하여 chargeback 결과와 같은 새로운 내용을 기록하세요. 메모는 나중에 편집할 수 있습니다.
• Reference IDs: 이 차단에 연결된 customer ID를 바로 복사할 수 있습니다.

​

고객 차단 해제

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

​

고객에게 표시되는 내용

• Checkout에서 결제가 일반적인 거절 메시지인 “This payment cannot be processed.”와 함께 실패합니다. API는 원인을 밝히지 않는 오류 코드 PAYMENT_NOT_PERMITTED와 함께 HTTP 403를 반환합니다. 실제 이유는 Dodo Payments의 로그에만 기록됩니다.
• Customer Portal에서 모든 항목을 볼 수 있지만 모든 작업이 비활성화됩니다. 차단된 write는 “This action is not available.” 메시지와 함께 PORTAL_ACTION_NOT_PERMITTED를 반환합니다. portal profile에는 read_only: true가 포함되므로 custom portal integration에서 자체 컨트롤을 비활성화할 수 있습니다. 포털에는 차단 목록 항목이나 메모가 절대 표시되지 않습니다.

​

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"

​

모범 사례

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

​

관련 항목