Kết nối Topup
Tài liệu hướng dẫn bạn hiểu về Topup và các thao tác kết nối Topup vào nền tảng platform PangoCDP.
Top up là gì?
Top up là dịch vụ mà người dùng có thể thanh toán nạp tiền điện thoại vào tài khoản trả trước thông qua các ứng dụng Ví điện tử, Internet, SMS hoặc tài khoản ngân hàng. Bạn có thể hiệu Top Up là một hình thức chuyển tiền Online vì bản chất là chuyển tiền tiền từ nơi này sang nơi khác được mã hoá bằng số điện thoại.
Thao tác tạo Access Token
Bước 1: Nhận thông tin kết nối API Topup
Phía nhà cung cấp Top up sẽ gửi thông tin tài khoản mà bạn đã đăng ký. Hiện tại PangoCDP đang open API với nhà cung cấp VietGuys.
Bước 2: Truy cập vào trang quản trị tài khoản kết nối API Topup
Truy cập vào link https://ai.vietguys.biz
Log-in tài khoản
Nhận OTP qua email và đăng nhập
Bước 3: Lấy thông tin Refresh-token
Lấy thông tin Refresh Token theo hướng dẫn tại link Refresh-token
Bước 4: Hỗ trợ lấy thông tin Access Token
Sau khi có thông tin về Refresh Token
Gửi lại phía PangoCDP để hỗ trợ Access Token, hoặc cũng có thể tham khảo tại link access-token.
Thao tác tạo kết nối Vietguys Mobile Topup.
Bước 1: Tạo đầu connect Topup trên PangoCDP
Vào Module Console
Click Connections
Click Digital Gifts
Chọn Manage
Bước 2. Tạo mới connect Vietguys Mobile Topup.
Click chọn tạo mới Connect
Điền thông tin vào trường Name
Bật nút Enabled
Chọn nút Save & Next
Bước 3. Tiến hành cài đặt connect Vietguys Mobile Topup.
Click chọn Extend Parameter
Điền thông tin
Chọn Save
Username
Tên đăng nhập được cung cấp bởi VGs
Password
Là thông tin passcode do bên VGs sẽ cung cấp.
Max time
Số lượng tối đa để gửi topup trên 1 phone. (Maxtime <=0 thì max time 1000)
Min topup Value
Giá trị topup nhỏ nhất.
Max topup Value
Giá trị topup lớn nhất.
Failover channel
Chọn kênh gửi tin nếu thao tác nộp tiền không thành công. Có 2 kênh SMS và Zalo UID
Ví dụ: đối vs nhà mạng vietnamobile không cho phép nạp topup 30k khi đó VGs sẽ gửi tin gồm mã thẻ cào và giá trị thẻ cào qua kênh đã chọn.
Failover Channel OA Id
Nếu tại trường Failover chọn kênh Zalo UID thì tại đây để lại thông tin ID của zalo OA. Còn chọn kênh SMS thì không cần điền thông tin.
Webhook Registration URL
Hệ thống pangoCDP tự sinh ra.
Webhook Registration Username
Tên đăng nhập webhook do VGs cung cấp. Có thể dùng luôn thông tin Username
Webhook Registration Token
Token đăng nhập webhook do VGs cung cấp. Có thể dùng luôn thông tin Password
Thao tác kiểm tra sau khi kết nối Top up
Bước 1: Kiểm tra kết nối
Click chọn Webhook
Chọn Register
PangoCDP sẽ trả thông báo trên giao diện thành công hay không thành công.
⇒ Khi Vietguys Mobile Topup không thành công sẽ hiển thị thông tin lý do cụ thể.
Ví dụ: Lý do: Thông tin xác thực chưa chính xác.
⇒ Khi Vietguys Mobile Topup thành công sẽ hiển thị thông tin Webhook URL.
Bước 2: Gửi testing Topup
Click chọn Testing
Điền thông tin các trường
Chọn Execute.
Send to
Nhập thông tin số phone nhận topup.
Amount
Nhập giá trị topup. Lưu ý: Chọn giá trị 10K.
Zalo User Id (Failover Zalo UID)
Nhập thông tin Zalo user Id của số phone nhận topup để nhận thông tin mã thẻ cào và giá trị thẻ cào khi VGs topup không thành công.
Lưu ý: Trường thông tin này phụ thuộc vào trường Failover Channel. Nếu tại trường Failover Channel chọn kênh Zalo UID => thì điền Zalo User Id. Còn chọn kênh SMS thì bỏ qua trường thông tin Zalo User Id
Bước 3: Kiểm tra lịch sử đã Topup
Click chọn Request log.
Status
Trạng thái Topup thành công hay thất bại
Issued: Thành công
ApiError: Thất bại
Phone
Số phone nhận topup
Tracked Time
Ghi nhận thời gian phát sinh topup.
Transaction
Thể hiện ID Topup và giá trị topup
Flowld
Thể hiện ID Workflow đang trả Topup
Last updated
Was this helpful?