Thông tin chung

Thông tin kết nối#

Mỗi kết nối API có một bộ thông tin riêng. Một tài khoản tạo được tối đa 30 kết nối, thẻ của mọi kết nối đều cộng tiền vào cùng ví của tài khoản.

• Partner ID
  Mô tả

  Mã kết nối 9 chữ số, gửi kèm mọi yêu cầu trong tham số partner_id.
• Partner Key
  Mô tả

  Khoá bí mật 32 ký tự, chỉ dùng để tạo sign và kiểm tra callback_sign. Không bao giờ gửi Partner Key trong yêu cầu.
• Loại API
  Mô tả

  Mỗi API cần kết nối có đúng loại: Đổi thẻ cào, Nạp cước/game hoặc Mua mã thẻ. Một kết nối có thể có nhiều loại.
• Trạng thái
  Mô tả

  Kết nối phải đang Hoạt động, nếu không API trả Api key chưa được bật. Kết nối mới tạo ở trạng thái Đang tắt cho tới khi quản trị viên kích hoạt (có thể được mở tự động sau vài phút).
• Số ví
  Mô tả

  Số ví của tài khoản sở hữu kết nối, gửi trong wallet_number của API Mua mã thẻ. Mọi kết nối của một tài khoản dùng chung ví.
• Callback URL và kiểu
  Mô tả

  Địa chỉ http hoặc https (tối đa 255 ký tự) nhận kết quả thẻ. Kiểu GET hoặc POST quyết định cách hệ thống gọi tới địa chỉ này.
• Địa chỉ IP
  Mô tả

  Danh sách IP, dải CIDR hoặc IPv6 máy chủ của bạn, không bắt buộc. Có danh sách thì API chỉ nhận yêu cầu từ các địa chỉ này.

Tạo và quản lý kết nối tại Kết nối API.

Endpoint#

Chỉ có một môi trường thật, dùng URL gốc của website.

• URL gốc
  Phương thức

  GET, POST
  Endpoint

  https://thepay1s.com
• Đổi thẻ: charging, check
  Phương thức

  POST, GET
  Endpoint

  https://thepay1s.com/chargingws/v2
• Đổi thẻ: bảng phí
  Phương thức

  GET
  Endpoint

  https://thepay1s.com/chargingws/v2/getfee
• Nạp cước/game
  Phương thức

  POST
  Endpoint

  https://thepay1s.com/api/rechargews
• Mua mã thẻ
  Phương thức

  POST
  Endpoint

  https://thepay1s.com/api/cardws
• Mua mã thẻ: sản phẩm
  Phương thức

  GET
  Endpoint

  https://thepay1s.com/api/cardws/products

• Gọi qua HTTPS để bảo vệ mã thẻ trên đường truyền.
• Dùng chung URL thật với key sandbox (Partner ID bắt đầu bằng sandbox_) để thử từ server của bạn: đổi thẻ dùng thẻ mẫu ở bảng Sandbox, nạp cước và mua thẻ chọn kết quả bằng đuôi request_id; callback đổi thẻ gửi thật kèm sandbox=1; không đụng tiền thật và không gọi nhà cung cấp. Lấy key, cộng tiền thử và xem đơn thử ở trang Sandbox.
• Đặt thời gian chờ phía bạn ít nhất 60 giây cho lệnh charging: hệ thống có thể chờ nhà cung cấp phản hồi trước khi trả kết quả.

Giới hạn và bảo mật#

Các giới hạn dưới đây đọc trực tiếp từ cấu hình hiện tại của hệ thống.

• Tối đa 30 thẻ lỗi trong 5 phút. Chạm giới hạn, kết nối bị tắt tự động và quản trị viên được báo; liên hệ hỗ trợ để mở lại.
• Tối đa 10 thẻ đang chờ xử lý cùng lúc, tính mọi thẻ API đang chờ của tài khoản. Vượt mức, thẻ mới bị từ chối với status=100.
• Nếu kết nối có danh sách Địa chỉ IP, API đổi thẻ (charging, check, getfee) và Nạp cước/game chỉ nhận yêu cầu từ các IP, dải CIDR hoặc IPv6 đó; để trống thì nhận từ mọi IP. API Mua mã thẻ bắt buộc có danh sách IP.
• Partner Key chỉ dùng phía máy chủ, không đưa vào ứng dụng di động hay JavaScript chạy trên trình duyệt.
• Chỉ gửi thẻ khách đã nhập đúng định dạng; thẻ sai hoặc đã sử dụng được tính vào giới hạn thẻ lỗi.

Câu hỏi thường gặp#