Khôi phục

Sự kiện Khôi phục Giỏ hàng Bị bỏ quên

Các sự kiện webhook dưới đây theo dõi vòng đời khôi phục giỏ hàng bị bỏ quên:

Sự kiện	Mô tả
`abandoned_checkout.detected`	Đã phát hiện một thanh toán bị bỏ quên. Được gửi khi một thanh toán được xác định là bị bỏ quên (thất bại hoặc chưa hoàn thành) và quy trình khôi phục bắt đầu.
`abandoned_checkout.recovered`	Khách hàng đã hoàn tất thanh toán qua liên kết khôi phục. Trường `recovered_payment_id` chứa ID thanh toán thành công.

Trường Payload Thanh toán Bị bỏ quên

string

bắt buộc

Thanh toán gốc đã bị bỏ quên. Sử dụng thông tin này để tra cứu chi tiết sản phẩm, số tiền và đơn vị tiền tệ.

string

bắt buộc

Thương hiệu mà checkout bị bỏ dở này thuộc về.

string

bắt buộc

Khách hàng đã bỏ dở checkout.

string

bắt buộc

Lý do checkout bị bỏ dở. Một trong các giá trị sau:

payment_failed — Khách hàng đã thử thanh toán nhưng thanh toán không thành công
checkout_incomplete — Khách hàng đã truy cập checkout nhưng chưa bao giờ thử thanh toán

string

bắt buộc

Trạng thái vòng đời hiện tại của lần khôi phục này. Một trong các giá trị sau:

abandoned — Đã phát hiện, chưa gửi email nào
recovering — Đã gửi ít nhất một email khôi phục
recovered — Khách hàng đã hoàn tất thanh toán
exhausted — Đã gửi tất cả email hoặc đã tìm thấy checkout mới hơn
opted_out — Khách hàng đã hủy đăng ký

string

bắt buộc

Dấu thời gian ISO 8601 khi checkout được xác định là bị bỏ dở.

string | null

ID thanh toán của khoản thanh toán khôi phục thành công. null cho đến khi checkout được khôi phục.

Ví dụ: Xử lý ACR Webhook

app.post('/webhooks/dodo', async (req, res) => {
  const event = req.body;

  switch (event.type) {
    case 'abandoned_checkout.detected':
      console.log(`Checkout abandoned: ${event.data.payment_id}`);
      console.log(`Reason: ${event.data.abandonment_reason}`);
      // Track abandonment in your analytics
      await trackAbandonment(event.data);
      break;

    case 'abandoned_checkout.recovered':
      console.log(`Checkout recovered: ${event.data.payment_id}`);
      console.log(`Recovery payment: ${event.data.recovered_payment_id}`);
      // Grant access, update records
      await handleRecovery(event.data);
      break;
  }

  res.json({ received: true });
});

Sự kiện Dunning

Các sự kiện webhook sau đây theo dõi vòng đời dunning của subscription:

Sự kiện	Mô tả
`dunning.started`	Một lần thử dunning đã được tạo cho subscription chuyển sang `on_hold` hoặc bị khách hàng hủy.
`dunning.recovered`	Khách hàng đã cập nhật phương thức thanh toán và khoản thanh toán tương ứng đã thành công. Trường `payment_id` chứa ID của khoản thanh toán thành công.

Các trường Payload của Dunning Attempt

string

bắt buộc

Subscription đã kích hoạt dunning attempt.

string

bắt buộc

Thương hiệu mà dunning attempt này thuộc về.

string

bắt buộc

Khách hàng sở hữu subscription.

string

bắt buộc

Trạng thái subscription đã kích hoạt quy trình thu hồi khoản thanh toán quá hạn. Một trong các giá trị sau:

on_hold — Đã dừng gia hạn do thanh toán thất bại
cancelled — Customer đã hủy từ Customer Portal

string

bắt buộc

Trạng thái vòng đời hiện tại của dunning attempt này. Một trong các giá trị sau:

recovering — Email dunning đang được gửi
recovered — Khách hàng đã cập nhật phương thức thanh toán và khoản thanh toán đã thành công
exhausted — Đã gửi tất cả email hoặc trạng thái subscription đã thay đổi

string

bắt buộc

Dấu thời gian ISO 8601 khi dunning attempt được tạo.

string | null

ID thanh toán của khoản thanh toán khôi phục thành công. null trong khi đang khôi phục.

Ví dụ: Xử lý Dunning Webhook

app.post('/webhooks/dodo', async (req, res) => {
  const event = req.body;

  switch (event.type) {
    case 'dunning.started':
      console.log(`Dunning started for subscription: ${event.data.subscription_id}`);
      console.log(`Trigger: ${event.data.trigger_state}`);
      // Track dunning in your system
      await trackDunning(event.data);
      break;

    case 'dunning.recovered':
      console.log(`Subscription recovered: ${event.data.subscription_id}`);
      console.log(`Recovery payment: ${event.data.payment_id}`);
      // Reactivate access, update records
      await handleDunningRecovery(event.data);
      break;
  }

  res.json({ received: true });
});

Đăng ký cả dunning.started và dunning.recovered để theo dõi toàn bộ vòng đời dunning. Sử dụng dunning.started để tạm dừng các thời gian gia hạn hoặc đánh dấu các subscription có nguy cơ trong hệ thống của bạn.

Abandoned Cart Recovery

Cấu hình chuỗi email ACR và các ưu đãi giảm giá.

Subscription Dunning

Cấu hình chuỗi email dunning cho các subscription quá hạn.

Subscription Webhooks

Các sự kiện vòng đời subscription liên quan như subscription.on_hold và subscription.cancelled.

Schema Payload Webhook

Webhook payload for abandoned_checkout.detected and abandoned_checkout.recovered events

abandoned_at

string<date-time>

bắt buộc

abandonment_reason

enum<string>

bắt buộc

Tùy chọn có sẵn:

payment_failed,

checkout_incomplete

brand_id

string

bắt buộc

Brand id this abandoned checkout belongs to

customer_id

string

bắt buộc

payment_id

string

bắt buộc

status

enum<string>

bắt buộc

Tùy chọn có sẵn:

abandoned,

recovering,

recovered,

exhausted,

opted_out

recovered_payment_id

string | null

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Sự kiện Khôi phục Giỏ hàng Bị bỏ quên

Trường Payload Thanh toán Bị bỏ quên

Ví dụ: Xử lý ACR Webhook

Sự kiện Dunning

Các trường Payload của Dunning Attempt

Ví dụ: Xử lý Dunning Webhook

Abandoned Cart Recovery

Subscription Dunning

Subscription Webhooks

Schema Payload Webhook

​Sự kiện Khôi phục Giỏ hàng Bị bỏ quên

​Trường Payload Thanh toán Bị bỏ quên

​Ví dụ: Xử lý ACR Webhook

​Sự kiện Dunning

​Các trường Payload của Dunning Attempt

​Ví dụ: Xử lý Dunning Webhook

Abandoned Cart Recovery

Subscription Dunning

Subscription Webhooks

​Schema Payload Webhook

Sự kiện Khôi phục Giỏ hàng Bị bỏ quên

Trường Payload Thanh toán Bị bỏ quên

Ví dụ: Xử lý ACR Webhook

Sự kiện Dunning

Các trường Payload của Dunning Attempt

Ví dụ: Xử lý Dunning Webhook

Schema Payload Webhook