Giới thiệu
Tích hợp Loops chuyển các sự kiện của Dodo Payments thành các sự kiện Loops, để email xác nhận thanh toán, cập nhật đăng ký và thông báo thanh toán thất bại được gửi dưới dạng email Loops. Một phép chuyển đổi ánh xạ từng sự kiện thanh toán thành một sự kiện Loops, sau đó sự kiện đó kích hoạt workflow tương ứng trong Loops.Bạn cần một API key Loops. Trong Loops, đi đến Settings → API và tạo một key.
Bắt đầu
1
Open the Webhook Section
Trong bảng điều khiển Dodo Payments, đi đến Developer → Webhooks và nhấp vào Add endpoint.

2
Select Loops
Trong danh sách Integration, chọn Loops.
3
Enter API Key
Dán API key Loops vào trường API key. Dodo Payments gửi key này dưới dạng header
Authorization trong mỗi lần gửi. Tích hợp sẽ thiết lập URL đích, vì vậy key là giá trị duy nhất bạn cần cung cấp.4
Configure Transformation
Chỉnh sửa đoạn code trong Transformation code để mỗi sự kiện trở thành một sự kiện Loops. Bắt đầu từ các ví dụ bên dưới. Trong Subscribed events, chọn các sự kiện mà code của bạn xử lý.
5
Test & Create
Trong Test this code, chạy phép chuyển đổi với một payload mẫu, sau đó nhấp vào Create endpoint.
6
Done
Các sự kiện thanh toán giờ đây sẽ kích hoạt email thông qua Loops.
Ví dụ Mã Biến đổi
Mỗi ví dụ viết lại một loại sự kiện thành body của API Send an Event của Loops: mộteventName, email của contact và eventProperties mà email Loops của bạn có thể sử dụng.
Email xác nhận thanh toán
Ví dụ này gửi một sự kiệnpayment_confirmation khi thanh toán thành công.
payment_confirmation.js
Email chào mừng đăng ký
Ví dụ này gửi một sự kiệnsubscription_welcome khi một đăng ký trở nên active.
subscription_welcome.js
Thông báo thanh toán thất bại
Ví dụ này gửi một sự kiệnpayment_failed cùng thông báo lỗi và liên kết thử lại. Thay yourdomain.com bằng domain của riêng bạn.
payment_failure.js
Mẹo
- Đặt tên mô tả cho từng sự kiện, chẳng hạn như
payment_confirmation, để các email Loops của bạn luôn được sắp xếp khoa học. - Bao gồm các thuộc tính customer mà email của bạn sử dụng để cá nhân hóa.
- Trong Loops, thiết lập một workflow và email cho mỗi tên sự kiện bạn gửi.
- Sử dụng cùng tên thuộc tính giữa các sự kiện.
- Kiểm tra việc gửi email trước khi đưa vào hoạt động.
Khắc phục sự cố
Emails Not Being Sent
Emails Not Being Sent
- Kiểm tra để đảm bảo API key chính xác và đang hoạt động.
- Kiểm tra để đảm bảo mỗi tên sự kiện khớp với sự kiện kích hoạt workflow Loops của bạn.
- Kiểm tra để đảm bảo địa chỉ email người nhận hợp lệ.
- Xem lại các giới hạn và quota gửi của Loops.
Transformation Errors
Transformation Errors
- Kiểm tra để đảm bảo payload khớp với định dạng API Loops: một
eventName, cùng với mộtemailhoặcuserId. - Kiểm tra để đảm bảo tất cả các trường bắt buộc đều có mặt.
- Kiểm tra để đảm bảo tên sự kiện được định dạng chính xác.
- Gán cho mỗi thuộc tính sự kiện một giá trị string, number, boolean hoặc date.
- Kiểm tra permissions của API key.