tài liệu tích hợp đổi thẻ cào thành tiền mặt tại thesieutoc.net

1.  Yêu cầu:

• Yêu cầu tối thiểu:
• • Có được APIKEY ở mục TÍCH HỢP API tại websise https://thesieutoc.net

(hình 1.1)

• • Hệ thống website muốn tích hợp api có tính năng thực hiện request http (CURL) có hỗ trợ OpenSSL phiên bản 2.0 trở lên.

1. Mô tả API:

• Quy trình gửi thẻ cào lên hệ thống và trả kết quả thẻ cào về hệ thống được chia làm 2 bước :
  • Bước 1: Gửi thẻ cào lên hệ thống:
    • Method: Hỗ trợ cả hai phương thức là POST và GET.
    • Accept: x-www-form-urlencoded.
    • Content Type: Text/json.
    • Body:
      • Url: https://thesieutoc.net/chargingws/v2
      • Data:

• Response (phản hồi):
  • Json: {"status":"00","transaction_id":"3c51eb5dbf559927d6417d5b01c2c5ab","title":"Tha\u0300nh c\u00f4ng","msg":"Th\u1ebb \u0111\u00e3 \u0111\u01b0\u1ee3c g\u1eedi l\u00ean h\u1ec7 th\u1ed1ng vui l\u00f2ng ch\u1edd x\u1eed l\u00fd"}

Trong đó:

• status:

• 54: Chưa Nhập API key
• 1: Sai Thông Tin API
• 3: tài khoản đã bị khóa
• -1089: Thẻ Đang Bảo Trì
• 2: Thẻ đã được sử dụng trên hệ thống
• 56: Chưa Nhập Seri
• 55: Chưa Nhập Mã Thẻ
• 52: Chưa Chọn Mệnh Giá
• 00: Nạp Thẻ Thành công hệ thống đang xử lý
• 47: Lỗi không xác định
  • Msg: là chuỗi thông báo kết quả gửi thẻ.

VD trên phần mềm Postman:

(Hình 1.2)

• Bước 2: Hệ thống trả kết quả thẻ về máy chủ website:
  • Ở bước này hệ thống sẽ căn cứ theo url callback đã được bạn cung cấp (Xem hình 1.1) để gửi thẻ về thông qua Curl.
  • Method: chỉ có phương thức POST.
  • Accept: x-www-form-urlencoded.
  • Data: