Webhooks – Thanh toán trong game – Tài liệu – Meta for Developers

Đăng ký Webhooks

Để đăng ký Webhooks cho Thanh toán, trước tiên, hãy tạo một URL điểm cuối công khai sẽ nhận cả HTTPS GET để xác minh gói đăng ký và POST để yêu cầu thay đổi dữ liệu. Cấu trúc của cả hai loại yêu cầu này được mô tả bên dưới. Tiếp theo, hãy thiết lập gói đăng ký đối tượng payment của ứng dụng. Bạn có 2 cách để thực hiện việc này:

Trong cả hai trường hợp, điểm cuối của bạn sẽ nhận được cùng dữ liệu theo cùng một cách. Hãy xem Máy chủ gọi lại của bạn để biết thêm thông tin về nội dung mà máy chủ sẽ nhận được.

Đăng ký qua Bảng điều khiển ứng dụng

Cách dễ nhất để thiết lập ứng dụng nhằm nhận thông tin cập nhật từ Webhooks là sử dụng bảng điều khiển Thanh toán của Bảng điều khiển ứng dụng. Tìm ứng dụng của bạn trong bảng điều khiển, sau đó nhấp vào tab Payments. Phần Webhooks sẽ nằm ngay dưới phần Cài đặt của công ty bạn.

Webhooks cho Thanh toán

Sau đó, màn hình này sẽ liệt kê trạng thái đăng ký của ứng dụng, cho dù đăng ký được thêm qua bảng điều khiển này hay qua API. Từ đây, bạn có thể thay đổi và thử nghiệm URL gọi lại gói đăng ký.

Trong trường “Gọi lại”, bạn phải cung cấp điểm cuối máy chủ hợp lệ có thể truy cập công khai. Đây là địa chỉ mà chúng tôi sẽ dùng để xác minh gói đăng ký cũng như gửi thông tin cập nhật. Điểm cuối này cần phản hồi như được mô tả trong Máy chủ gọi lại của bạn.

Cuối cùng, hãy cung cấp “Mã xác minh”. Mã này sẽ chỉ được gửi trong giai đoạn đăng ký để xác minh rằng bạn đang thực hiện đăng ký từ một vị trí an toàn. Mã này sẽ không được gửi khi có thông tin cập nhật thông thường từ Webhook.

Thử nghiệm cài đặt của bạn

Bạn phải thử nghiệm cài đặt gọi lại trước khi lưu gói đăng ký. Thao tác này sẽ gửi yêu cầu GET xác minh đến điểm cuối của bạn. Yêu cầu này chứa các thông số hub.mode, hub.challenge và hub.verify_token, đồng thời đảm bảo rằng bạn xử lý chúng đúng cách. Ví dụ: bạn phải đảm bảo điểm cuối sẽ trả về hub.challenge cho Facebook:

Thử nghiệm cài đặt của bạn

Sau khi nhập chi tiết gói đăng ký, hãy nhớ nhấp vào nút “Lưu thay đổi” ở cuối trang. Chỉnh sửa gói đăng ký là một thao tác đơn giản để sửa đổi nội dung trường, thử nghiệm lại rồi lưu lại mẫu.

Đăng ký qua API Đồ thị

Bạn cũng có thể thiết lập và liệt kê gói đăng ký theo lập trình thông qua API Đồ thị. Bạn sẽ cần access token của ứng dụng. Bạn có thể lấy mã này trong Công cụ tạo mã truy cập hoặc qua điểm cuối /oauth của API Đồ thị

API Đăng ký có sẵn trên điểm cuối https://graph.facebook.com/[APP_ID]/subscriptions

Với API này, bạn có thể thực hiện 3 tác vụ:

• Thêm hoặc sửa đổi gói đăng ký (bằng cách gửi yêu cầu HTTPS POST)

• Liệt kê từng gói đăng ký hiện có của bạn (bằng cách gửi yêu cầu HTTPS GET)

Thêm và sửa đổi gói đăng ký

Để thiết lập gói đăng ký, hãy gửi POST kèm theo thông số sau. Lưu ý rằng những thông số này tương ứng với các trường trong mẫu được mô tả ở trên:

• object – Giống như trên, đây là loại đối tượng bạn muốn nhận thông tin cập nhật. Chỉ định payments.

• fields – Danh sách các thuộc tính của loại đối tượng mà bạn muốn nhận thông tin cập nhật về thay đổi. Danh sách này được phân tách bằng dấu phẩy. Chỉ định “hành động” và “tranh chấp”.

• callback_url – Điểm cuối máy chủ hợp lệ và có thể truy cập công khai.

• verify_token – Một chuỗi tùy ý được gửi đến điểm cuối của bạn khi xác minh gói đăng ký.

Khi nhận được yêu cầu này, giống với cấu hình mẫu ở trên, chúng tôi sẽ gửi yêu cầu GET đến điểm cuối gọi lại của bạn để đảm bảo rằng đăng ký hợp lệ và sẵn sàng nhận thông tin cập nhật. Cụ thể, bạn phải đảm bảo điểm cuối của mình trả về hub.challenge cho Facebook.

Lưu ý rằng mỗi loại đối tượng của ứng dụng chỉ có thể có một gói đăng ký. Vì thế, nếu một gói đăng ký đã tồn tại cho loại đối tượng này thì dữ liệu mới đăng sẽ thay thế bất kỳ dữ liệu hiện có nào.

Liệt kê các gói đăng ký của bạn

Việc gửi yêu cầu HTTP GET đến API Đăng ký sẽ trả về nội dung được mã hóa JSON liệt kê các gói đăng ký của bạn. Ví dụ:

[  {    "object": "payments",    "callback_url": "https://www.friendsmash.com/rtu.php",    "fields": ["actions", "disputes"],    "active": true  }]

Bạn có thể sử dụng Trình khám phá đồ thị để thử nghiệm trực tiếp với API này, hãy nhớ sử dụng mã truy cập của ứng dụng.