Nếu bạn muốn đăng ký làm đại lý để gửi đơn nạp cước viễn thông với chiết khấu từ 20% xin hãy đọc kỹ hướng dẫn sau:
Việc tích hợp với API được thực hiện qua giao thức HTTP, vì thế dễ dàng tích hợp vào bất cứ nền tảng, ngôn ngữ lập trình nào.
Việc gạch thẻ được thực hiện qua 2 bước
Việc nhận kết quả được thực hiện thông qua một trong hai cách:
Sử dụng HTTP POST để gửi thông tin thẻ về địa chỉ https://doithevn.com/api/card với:
Tên trường |
Kiểu dữ liệu |
Bắt buộc |
Mô tả |
ApiKey |
String |
x |
Key duy nhất để xác định merchant |
Pin |
String |
x |
Mã code của thẻ cào |
Seri |
String |
x |
Mã seri của thẻ cào |
CardType |
Integer |
x |
Loại thẻ cào, nhận một trong các giá trị: 1 : Viettel |
CardValue |
Integer |
x |
Mệnh giá thẻ cào (10000, 20000, 50000…)
|
Tên trường |
Kiểu dữ liệu |
Mô tả |
Code |
Integer |
Mã thông báo xác định trạng thái của request 1: Thành công 0: Không thành công |
Message |
String |
Thông báo tương ứng với Code |
TaskID |
String |
ID để truy vấn trạng thái gạch thẻ |
Tên trường |
Kiểu dữ liệu |
Mô tả |
Code |
Integer |
Mã trạng thái gạch thẻ 1: Hệ thống đang xử lý 2: Nạp thẻ thành công 3: Nạp thẻ thất bại |
Message |
String |
Thông báo tương ứng với Code nếu có |
CardValue |
Integer |
Mệnh giá thẻ nạp nếu thành công |
Url nhận kết quả xử lý phải đảm bảo:
Tên trường |
Kiểu dữ liệu |
Mô tả |
TaskId |
String |
Id của yêu cầu gạch thẻ |
Pin |
String |
Mã pin yêu cầu |
Seri |
String |
Mã seri yêu cầu |
CardValue |
Integer |
Mệnh giá thẻ nạp nếu thành công |
Success |
Boolean |
true: Gạch thẻ thành công false: Gạch thẻ lỗi |
Lưu ý: Nên sử dụng PostMan để kiểm tra webhook trước bằng cách gửi một HTTP Post đến webhook của bạn với dữ liệu như sau: