Customer Blocklist

Customer Blocklist किसी ज्ञात बुरे उपयोगकर्ता को आपसे दोबारा खरीदारी करने से रोकती है। ब्लॉक किया गया customer भुगतान नहीं कर सकता, उसकी live subscriptions समाप्त हो जाती हैं, और वह Customer Portal में अपना account देख सकता है, लेकिन अपनी subscriptions में बदलाव नहीं कर सकता। Blocklist को Settings → Blocklist से या Blocklist API के माध्यम से manage करें।

Blocklist settings page showing the total number of blocked customers, a table of blocked entries with identifier, blocked by, and blocked on columns, and an Add to Blocklist button — The Blocklist tab under Settings

ग्राहक को ब्लॉक करने पर क्या होता है

इनमें से प्रत्येक area में block जोड़ते ही प्रभावी हो जाता है:

Area	Effect
Checkout	ब्लॉक किए गए email से किया गया हर payment attempt अस्वीकार कर दिया जाता है: payment links, checkout sessions, और API के माध्यम से बनाई गई payments या subscriptions।
Live subscriptions	`pending`, `active`, `on_hold`, या `paused` status वाली subscriptions को `cancelled_by_merchant` कारण के साथ cancel कर दिया जाता है। प्रत्येक के लिए सामान्य `subscription.cancelled` webhook fire होता है।
Renewals and retries	Automatic renewals और payment retries ब्लॉक किए गए customer को skip करते हैं, इसलिए cancellation अभी pending होने पर भी कोई और charge नहीं लिया जाता।
Manual retry	ब्लॉक किए गए customer के payment का manual retry अस्वीकार कर दिया जाता है।
Customer Portal	Customer अभी भी log in करके invoices, subscriptions और license keys देख सकता है। वह subscription cancel, pause या resume नहीं कर सकता, plans बदल नहीं सकता, payment method update नहीं कर सकता या invoice address edit नहीं कर सकता। वह saved payment method हटा सकता है।

Blocking से पिछले payments refund नहीं होते और open disputes पर इसका कोई प्रभाव नहीं पड़ता। कोई भी refund Refunds page से अलग से issue करें।

Customers को Block करने का मिलान कैसे होता है

आप customer ID या email से block कर सकते हैं। दोनों ही स्थितियों में block customer record पर नहीं, बल्कि customer के email पर आधारित होता है:

उस email वाले हर record पर लागू होता है। Checkout लौटने वाले email के लिए नया customer record बना सकता है, इसलिए केवल एक customer ID पर लगाया गया block bypass किया जा सकता है। Email पर लगाया गया block bypass नहीं किया जा सकता।
Aliases पर भी लागू होता है। Emails की तुलना lowercase में की जाती है और कोई भी +alias हटा दिया जाता है, इसलिए buyer+promo@example.com और Buyer@example.com को एक ही customer माना जाता है। Address में मौजूद dots वैसे ही रखे जाते हैं।
आपके business तक सीमित। Block केवल आपके business पर लागू होता है। वही email Dodo Payments पर अन्य businesses से खरीदारी कर सकता है।
Email किसी existing customer का होना चाहिए। आप ऐसे email को block नहीं कर सकते जो आपके किसी customer से match न करता हो, और ऐसे customer record को भी block नहीं कर सकते जिसमें email न हो।

Customer को Block करना

आप Blocklist page से या customer के अपने page से customer को block कर सकते हैं।

From Settings
From the customer's page

Open the Blocklist

अपने dashboard में Settings → Blocklist पर जाएँ।

Add to Blocklist

Add to Blocklist पर click करें, फिर Customer ID or email में customer का email या customer ID दर्ज करें। Panel matching customer दिखाता है।

Confirm

Panel में Add to Blocklist पर click करें। Customer की live subscriptions तुरंत cancel कर दी जाती हैं और entry Blocked entries table में दिखाई देती है। यदि कुछ subscriptions अभी भी cancel हो रही हों, तो dashboard एक notice दिखाता है। थोड़ी देर बाद page refresh करके जाँच करें।

Dashboard कारण नहीं पूछता। Customer को block करने का कारण दर्ज करने के लिए customer के page पर note जोड़ें, या API के माध्यम से block करते समय reason भेजें।

Block किए गए Customers को Manage करना

Blocklist page हर active block को list करता है:

Total Customers Blocked: वर्तमान में block किए गए customers की संख्या।
Blocked entries: प्रत्येक block के लिए एक row, जिसमें आपके द्वारा दर्ज किया गया Identifier (email या customer ID), Blocked By, और Blocked On शामिल हैं। Blocked By उस team member को दिखाता है जिसने block जोड़ा था, या API key से जोड़े गए block के लिए API दिखाता है।
Search Identifier और Filters: email या customer ID से entry खोजें, या Blocked By और Blocked Between से filter करें।
Action: See Details blocked customer का page खोलता है और Unblock block हटाता है। Viewer role वाले team members unblock नहीं कर सकते।

Block किए गए Customer का Page

Blocked customer के लिए Customer Information page, जिसमें Blocked badge, Unblock Customer button, note और Added to blocklist event वाला Activity Log, तथा customer ID वाला Reference IDs panel दिखाया गया है — A blocked customer's details page

किसी blocked customer को Sales → Customers या Blocklist page से खोलकर देखें:

Customer के नाम के आगे Blocked badge और Unblock Customer button।
Activity Log: Customer को blocklist में कब जोड़ा गया, कारण, और उसके बाद आपकी team द्वारा जोड़े गए notes। Chargeback के परिणाम जैसी नई जानकारी दर्ज करने के लिए Add Note पर click करें। बाद में API के माध्यम से note edit कर सकते हैं।
Reference IDs: इस block से जुड़ा customer ID, जिसे copy किया जा सकता है।

Customer को Unblock करना

Customer को unblock करने के लिए customer के page पर Unblock Customer पर click करें, या Blocklist page के Action column में Unblock चुनें। फिर Unblock से confirm करें।

Checkout और Customer Portal में बदलाव तुरंत restore हो जाते हैं।
Cancelled subscriptions दोबारा active नहीं होतीं। Customer को फिर से purchase करना होगा।
Entry को उसकी notes के साथ audit record के रूप में रखा जाता है, लेकिन यह active list में दिखाई नहीं देती।
आप बाद में उसी customer को फिर से block कर सकते हैं। इससे नई entry बनती है।

Customer को क्या दिखाई देता है

Blocked customer को कभी नहीं बताया जाता कि उसे block किया गया है।

Checkout पर, payment एक सामान्य decline के साथ fail होता है: “This payment cannot be processed.” API error code PAYMENT_NOT_PERMITTED के साथ HTTP 403 लौटाती है, जिसमें किसी कारण का उल्लेख नहीं होता। वास्तविक कारण केवल Dodo Payments के logs में लिखा जाता है।
Customer Portal में, सब कुछ दिखाई देता है, लेकिन account बदलने वाली हर action अस्वीकार कर दी जाती है। अस्वीकार की गई action PORTAL_ACTION_NOT_PERMITTED और message “This action is not available.” के साथ HTTP 403 लौटाती है। Portal profile में read_only: true होता है, इसलिए custom portal integration अपने controls disable कर सकता है। Portal कभी भी blocklist entry या उसकी notes उजागर नहीं करता।

यदि आप अपने product में checkout या portal errors render करते हैं, तो यही behavior बनाए रखें। PAYMENT_NOT_PERMITTED और PORTAL_ACTION_NOT_PERMITTED के लिए सामान्य message दिखाएँ। Block उजागर करने से bad actor को अलग email आज़माने का संकेत मिल जाता है।

API का उपयोग करना

Blocklist API आपको अपने tooling से block करने देता है, उदाहरण के लिए chargeback आने पर। इसके लिए आपकी secret API key आवश्यक है। कोई भी key entries list कर सकती है और notes पढ़ सकती है। write access enabled वाली key block, unblock और notes manage कर सकती है। Dashboard team roles पर भी यही विभाजन लागू करता है: Viewer role list पढ़ता है और Editor role बदलाव करता है। Blocklist API में छह endpoints हैं:

Method	Endpoint	Purpose
`GET`	`/blocklist/customers`	Filters और `total` count के साथ blocked customers की list देना
`POST`	`/blocklist/customers`	Customer ID या email से customer को block करना
`GET`	`/blocklist/customers/{entry_id}`	Notes के साथ entry प्राप्त करना
`DELETE`	`/blocklist/customers/{entry_id}`	Customer को unblock करना
`POST`	`/blocklist/customers/{entry_id}/notes`	Note जोड़ना
`PATCH`	`/blocklist/customers/{entry_id}/notes/{note_id}`	Note update करना

List केवल active blocks लौटाती है। इसे filter करने के लिए identifier (email या customer ID पर partial, case-insensitive match), blocked_by_email, created_at_gte या created_at_lte भेजें। यह default रूप से प्रति page 10 entries लौटाती है: अधिकतम 100 लौटाने के लिए page_size सेट करें और pages के बीच जाने के लिए page_number सेट करें।

Customer को Block करना

Body के top level पर customer_id या email में से कोई एक भेजें। यदि दोनों भेजते हैं, तो block customer_id का उपयोग करता है। reason optional है और entry के page पर दिखाई देता है। नया block HTTP 201 लौटाता है।

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"
  }'

Response entry और उस call द्वारा cancel की गई subscriptions का विवरण देती है:

Response

{
  "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
}

इन fields पर सबसे अधिक ध्यान दें:

Field	Description
`identifier`	आपके द्वारा भेजा गया customer ID या email।
`source`	Block कहाँ से आया: `blocklist_page`, `customer_page`, `payment_page`, `dispute_page` या `api`। API key हमेशा `api` record करती है, चाहे आप कोई भी `source` भेजें।
`blocked_by_email`	वह dashboard user जिसने block जोड़ा। API key के लिए `null`।
`cancelled_subscription_ids`	इस call द्वारा cancel की गई subscriptions। केवल create response में मौजूद।
`remaining_subscription_ids`	अभी भी live subscriptions, क्योंकि cancellation fail हुई या call 25 cancellations की सीमा तक पहुँच गई।
`subscriptions_swept`	जब live subscriptions बाकी हों या Dodo Payments उन्हें list न कर पाया हो, तब `false`। Call को तब तक दोहराएँ जब तक यह `true` न हो जाए। Block स्वयं पहले से लागू है।

पहले से blocked customer को block करने पर HTTP 409 और CUSTOMER_ALREADY_BLOCKED लौटता है, जब तक कि subscriptions cancel होने की प्रतीक्षा में न हों। उस स्थिति में call cancellation जारी रखती है और HTTP 200 लौटाती है।

जाँचें कि Customer Blocked है या नहीं

Get Customer Detail दो अतिरिक्त fields लौटाता है: blocked_at, active block जोड़े जाने का समय (यदि customer blocked नहीं है तो null), और blocklist_entry_id, जो उससे जुड़ी entry है। List Customers endpoint दोनों को empty रखता है।

Customer को Unblock करना

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"

सफलता पर endpoint HTTP 204 लौटाता है, और जब ID किसी active block से match नहीं करती तो HTTP 404 लौटाता है। Unblocking से checkout और portal writes restore हो जाते हैं, लेकिन कोई subscription reactivate नहीं होती।

Best Practices

कारण record करें। Block पर दिया गया छोटा reason और बाद में होने वाली किसी भी घटना के लिए notes आपकी support team को पूरी जानकारी देते हैं, बिना dashboard छोड़े।
Chargeback के बाद block करें। Dispute या payment से customer का page खोलकर वहीं block करें, या dispute.opened webhook से POST /blocklist/customers के साथ इसे automate करें। Disputes देखें।
subscriptions_swept जाँचें। API के माध्यम से block करते समय call को तब तक दोहराएँ जब तक response true report न करे, ताकि कोई live subscription बाकी न रहे।
अलग से refund करें। Block केवल future purchases रोकता है। यदि customer को पैसे लौटाने हैं, तो payment को सामान्य तरीके से refund करें।
List की समीक्षा करें। जिन customers की समस्या हल हो गई है उन्हें unblock करें। Unblocking तुरंत प्रभावी होता है और history सुरक्षित रखता है।

Customer Management

Customer खोजें, उसका details page खोलें और उसकी subscriptions manage करें।

Customer Portal

Blocked customer portal में क्या कर सकता है और क्या नहीं।

Disputes

Chargebacks का जवाब दें और तय करें कि block कब उचित है।

Error Codes

PAYMENT_NOT_PERMITTED और PORTAL_ACTION_NOT_PERMITTED का अर्थ।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

ग्राहक को ब्लॉक करने पर क्या होता है

Customers को Block करने का मिलान कैसे होता है

Customer को Block करना

Block किए गए Customers को Manage करना

Block किए गए Customer का Page

Customer को Unblock करना

Customer को क्या दिखाई देता है

API का उपयोग करना

Customer को Block करना

जाँचें कि Customer Blocked है या नहीं

Customer को Unblock करना

Best Practices

Customer Management

Customer Portal

Disputes

Error Codes

​ग्राहक को ब्लॉक करने पर क्या होता है

​Customers को Block करने का मिलान कैसे होता है

​Customer को Block करना

​Block किए गए Customers को Manage करना

​Block किए गए Customer का Page

​Customer को Unblock करना

​Customer को क्या दिखाई देता है

​API का उपयोग करना

​Customer को Block करना

​जाँचें कि Customer Blocked है या नहीं

​Customer को Unblock करना

​Best Practices

​Related

Customer Management

Customer Portal

Disputes

Error Codes

ग्राहक को ब्लॉक करने पर क्या होता है

Customers को Block करने का मिलान कैसे होता है

Customer को Block करना

Block किए गए Customers को Manage करना

Block किए गए Customer का Page

Customer को Unblock करना

Customer को क्या दिखाई देता है

API का उपयोग करना

Customer को Block करना

जाँचें कि Customer Blocked है या नहीं

Customer को Unblock करना

Best Practices

Related