Hàm mua thẻ cào

Hàm cho phép bạn mua thẻ điện thoại.

HTTP request

POST http://api.omitopup.com/api/cardcode

  • Content Type: application/json

  • Response Type: application/json

curl --location --request POST 'http://omitopup.com/api/cardcode' \
--header 'token: {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"network":{{network}},
"price":"{{price}}"
}'
  • Cấu trúc body của request:

Thuộc tính
Mô tả

token *

Bạn sẽ được cung cấp khi sử dụng hàm đăng nhập.

network

Là nhà mạng bạn muốn mua thẻ cào. 1: Viettel 2: Mobiphone 3: Vinaphone 4: Vietnammobile 5: Gtel

price *

Mệnh giá thẻ cào.

sandbox

Kiểm tra kết nối 1: thử nghiệm, không mua card. 0: không thử nghiệm, mua card.

requestid

Id đối tác gửi sang eSMS

*Lưu ý:

  • ID này sẽ check trùng với ID khác

  • ID này có thể sử dụng để check trạng thái từ Hàm API lấy trạng thái của eSMS.

  • Response:

{
"resultCode": 100,
"cardCode": "59001254178553:12312542358373:10000:Vinaphone:31/12/2025",
"message": "Thành công",
"referenceid": "5a123c6c-0f3f-4ca2-9775-e1cb4faf9add"
}
  • Cấu trúc body của response:

Thuộc tính
Mô tả

resultCode

100: Thành công. 106: Truyền sai network. 103: Hết tiền trong tài khoản. 101: Sai Token. 107: Số tiền không đúng Hiện tại: đang là bội của 1000. 200: Kết nối thành công (Sandbox). 111: Địa chỉ IP chưa được Whitelist. 99: Lỗi không xác định.

message

Thông báo thành công hay thất bại của request.

referenceid

Id hệ thống topup trả về người dùng.

cardCode

Thông tin card mà eSMS trả về. Ví dụ: 59001254178553:12312542358373:10000:Vinaphone:31/12/2025

  • Thứ tự cardCode: seri, mã, mệnh giá,nhà mạng,etc

Last updated