Daftar Blokir Pelanggan

​

Yang Terjadi Saat Anda Memblokir Pelanggan

​

Cara Pemblokiran Mencocokkan Pelanggan

• Setiap record dengan email tersebut tercakup. Checkout dapat membuat customer record baru untuk email yang kembali berbelanja, sehingga pemblokiran berdasarkan satu customer ID dapat dilewati. Pemblokiran berdasarkan email tidak dapat dilewati.
• Alias juga tercakup. Email dibandingkan dalam huruf kecil dengan +alias dihapus, sehingga buyer+promo@example.com dan Buyer@example.com dianggap sebagai pelanggan yang sama. Titik dalam alamat email tetap dipertahankan.
• Berlaku hanya untuk bisnis Anda. Pemblokiran hanya berlaku untuk bisnis Anda. Email yang sama tetap dapat digunakan untuk membeli dari bisnis lain di Dodo Payments.
• Email harus dimiliki pelanggan yang sudah ada. Anda tidak dapat memblokir email yang belum pernah melakukan checkout dengan Anda, dan customer record tanpa email tidak dapat diblokir.

​

Memblokir Pelanggan

​

Mengelola Pelanggan yang Diblokir

• Total Customers Blocked: Jumlah pelanggan yang saat ini diblokir.
• Blocked entries: Satu baris untuk setiap pemblokiran, dengan Identifier yang Anda masukkan (email atau customer ID), Blocked By (anggota tim yang menambahkan pemblokiran), dan Blocked On.
• Search Identifier dan Filters: Temukan entri berdasarkan email atau customer ID, atau filter berdasarkan siapa yang memblokir dan waktunya.
• Action: Kelola entri, termasuk membuka blokir pelanggan.

​

Halaman Pelanggan yang Diblokir

• Badge Blocked di samping nama pelanggan dan tombol Unblock Customer.
• Activity Log: Waktu pelanggan ditambahkan ke daftar blokir, alasannya, dan catatan yang telah ditambahkan tim Anda sejak saat itu. Klik Add Note untuk mencatat konteks baru, seperti hasil chargeback. Catatan dapat diedit nanti.
• Reference IDs: Customer ID yang terkait dengan pemblokiran ini, siap untuk disalin.

​

Membuka Blokir Pelanggan

• Perubahan pada Checkout dan Customer Portal segera dipulihkan.
• Subscription yang dibatalkan tidak diaktifkan kembali. Pelanggan harus membeli lagi.
• Entri tetap disimpan sebagai audit record bersama catatannya, tetapi tidak lagi muncul dalam daftar aktif.
• Anda dapat memblokir pelanggan yang sama lagi nanti. Tindakan tersebut akan membuat entri baru.

​

Yang Dilihat Pelanggan

• Saat checkout, pembayaran gagal dengan penolakan umum: “This payment cannot be processed.” API mengembalikan HTTP 403 dengan error code PAYMENT_NOT_PERMITTED, yang tidak menyebutkan penyebab apa pun. Alasan sebenarnya hanya ditulis dalam log Dodo Payments.
• Di Customer Portal, semua hal terlihat tetapi setiap tindakan dinonaktifkan. Write yang diblokir mengembalikan PORTAL_ACTION_NOT_PERMITTED dengan pesan “This action is not available.” Profil portal menyertakan read_only: true sehingga integrasi portal kustom dapat menonaktifkan kontrolnya sendiri. Portal tidak pernah menampilkan entri daftar blokir atau catatannya.

​

Menggunakan API

​

Memblokir Pelanggan

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
}

​

Memeriksa Apakah Pelanggan Diblokir

​

Membuka Blokir Pelanggan

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"

​

Praktik Terbaik

• Catat alasannya. Alasan singkat pada pemblokiran, ditambah catatan untuk hal-hal yang terjadi kemudian, memberi tim dukungan Anda gambaran lengkap tanpa meninggalkan dashboard.
• Blokir setelah chargeback. Buka pelanggan dari dispute atau payment, lalu blokir dari sana, atau otomatisasi dari webhook dispute.opened dengan POST /blocklist/customers. Lihat Disputes.
• Periksa subscriptions_swept. Saat memblokir melalui API, ulangi panggilan hingga respons melaporkan true, sehingga tidak ada subscription aktif yang tertinggal.
• Lakukan refund secara terpisah. Pemblokiran hanya menghentikan pembelian berikutnya. Jika Anda harus mengembalikan uang pelanggan, lakukan refund payment seperti biasa.
• Tinjau daftar. Buka blokir pelanggan yang masalahnya telah terselesaikan. Pembukaan blokir berlaku segera dan tetap menyimpan riwayat.

​

Terkait