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