Hướng dẫn kết nối API thu thẻ và đổi thẻ 2024

  • Tích hợp API tự động đổi thẻ cào ra VND, ATM tự động dành cho Shop game và Web dịch vụ khác. Số dư được cộng trực tiếp tại vào khoản ví.

1. Thu thẻ

Phiên bản Version 1.0
Link API thu thẻ:
Phương thức: GET
Parameter:
  • : là ID đối tác được cấp bởi hadongpho.com
  • : seri thẻ cào
  • : mã thẻ cào
  • : Mệnh giá thẻ cào
  • : mạng
    • : Viettel
    • : Vinaphone
    • : Mobifone
  • : Mã tham chiếu của khách hàng gửi lên. Mã này sẽ được trả lại qua callback
  • : Link nhận kết quả gạch thẻ
  • : Chữ ký xác thực giao dịch md5(merchant_key+cardseri+cardcode+cardtype)
Kết quả

Không thành công

                                {
                                    "status": -1,
                                    "message": "code hoặc serial của thẻ đã tồn tại",
                                    "data": null
                                }
                            

Thành công

                                {
                                    "status": 1,
                                    "message": "Nhận thẻ thành công",
                                    "data": {
                                        "transid": "8412429T2A1595308581"
                                    }
                                }
                            
Mã lỗi
  • : Nhận thẻ thành công
  • :Thẻ đã tồn tại
  • : Thẻ sai định dạng.
  • : Thẻ sai mệnh giá.
  • : signature không chính xác.
  • : merchant_id không chính xác.
  • : Tài khoản đang tạm khóa, Vui lòng liên hệ support

2. Callback

Url Callback callback_url được gửi lên khi gửi thẻ
Phương thức GET
Parameter
  • : Trạng thái của thẻ cào
    • : Thẻ sai hoặc đã sử đụng.
    • : Gạch thẻ thành công.
  • : Giá trị thực của thẻ
  • : Mã tham chiếu
  • : transaction id của thẻ. (Gửi thẻ thành công sẽ trả ra giá trị này)