Kính chào đại lý

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:

1. Bạn đăng ký tại khoản trên trang doithevn.com sau đó gửi tiền vào tài khoản theo hướng dẫn trên trang. Ngay sau khi chúng tôi nhận được tiền sẽ cộng vào tài khoản cho bạn.
2. Bạn vào mục đăng ký nạp cước để gửi số điện thoại cần nạp, lưu ý hãy viết đúng sđt nếu viết sai chúng tôi không chịu trách nhiệm
3. gửi tiền tối thiểu 50.000
4. Khi làm lệnh hãy kiên nhẫn chờ đợi chúng tôi xử lý theo danh sách xếp hàng .
5. Nếu quý khách có vấn đề gì xin liên hệ 0912.848.292.
6. --------- --- HƯỚNG DẪN KẾT NỐI API CHO ĐỐI TÁC

7. Hướng dẫn tích hợp API

    

   1.Lấy API Key

8. Đăng nhập vào hệ thống tại địa chỉ https://doithevn.com/api/login
9. Vào mục API Key để lấy khóa truy cập

10. 

    2.Tích hợp API

    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

11. Gửi thông tin thẻ cần gạch sang doithevn.com qua HTTP POST.
12. Nhận kết quả gạch thẻ

13.  

    Việc nhận kết quả được thực hiện thông qua một trong hai cách:

14. Sử dụng HTTP GET để pull kết quả gạch thẻ, theo cách này ta cần chủ động pull kết quả xử lý cho đến khi việc xử lý kết thúc.
15. Sử dụng WebHook, một URL được cung cấp để nhận kết quả xử lý. Khi xử lý kết thúc doithevn.com sẽ gửi trả kết quả qua HTTP POST.

16.  

     

     

    2.1Gạch thẻ

    Sử dụng HTTP POST để gửi thông tin thẻ về địa chỉ https://doithevn.com/api/card với:

17. Content-Type=application/json
18. Dữ liệu JSON gồm các trường như sau:

19. 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 2:  MobiFone 3: VinaPhone 4: Vcoin-VTC Game 5: SohaCoin 6: Garena 7: Zing 8: Bit 9: Gate
    CardValue	Integer	x	Mệnh giá thẻ cào (10000, 20000, 50000…)

     

20. Kết quả trả về JSON gồm các trường sau

21. 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ẻ

    2.2. Truy vấn trạng thái gạch thẻ qua HTTP GET

22. Sử dụng HTTP GET để truy vấn trạng thái gạch thẻ https://doithevn.com/api/card/{TaskID}
23. {TaskID} được thay bằng giá trị trả về từ kết quả của HTTP POST trong bước gạch thẻ
24. Giá trị trả về JSON object như sau:

25. 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

     

    2.3. Truy vấn trạng thái gạch thẻ qua WebHook

26. Đăng nhập vào hệ thống tại địa chỉ https://doithevn.com/api/login
27. Vào mục WebHook để cập nhật URL nhận kết quả (địa chỉ nhận kết quả xử lý)

28. 

    Url nhận kết quả xử lý phải đảm bảo:

29. Chấp nhận HTTP POST
30. Chấp nhận Content-type=application/json
31. Dữ liệu xử JSON được bao gồm các trường sau:

32. 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: