Hướng dẫn đại lý


 

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: