{"info":{"_postman_id":"3a852614-b63a-4b2a-a2bc-54f1fd1e33a7","name":"Tài liệu hướng dẫn tích hợp đổi thẻ cào APIdoithe.Com","description":"
\n

Trang chủ: API Đổi thẻ cào: apidoithe.com
Hỗ trợ:
- Telegram: https://t.me/tieutran01
- Zalo: 0966663393

\n
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"5472976","collectionId":"3a852614-b63a-4b2a-a2bc-54f1fd1e33a7","publishedId":"2s8YzQV3Ua","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"053037","highlight":"0c7b8d"},"publishDate":"2022-12-07T08:33:08.000Z"},"item":[{"name":"Gửi thẻ cào sang apidoithe.com","id":"ce131965-4d3f-4285-aacb-0b8799bd1149","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://apidoithe.com/chargingws/v2","description":"

Bạn có thể gửi bằng phương thức get hoặc post tùy thích.

\n\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Tên tham sốGiải thíchKiểu dữ liệu
request_idID tùy ý tạo và lưu lại phía bên bạn, để khi có kết quả đổi thẻ, sẽ trả kèm dữ liệu kết quả, mục đích phân biệt thẻ khi bạn cần cập nhật trạng thái thẻ bên bạn.Chuỗi
serialSeri của thẻ càoChuỗi
codeMã của thẻ càoChuỗi
telcoNhà mạng của thẻ.
Bao gồm: VIETTEL, MOBIFONE, VINAPHONE, VNMOBI, ZING, GATE		Chuỗi
amountMệnh giá thẻ cào khách khai báoSố nguyên
partner_idPartner ID này lấy tại mục kết nối APISố nguyên
signLà kết quả sau khi mã hóa MD5 của chuỗi partner_key, code và serial nối liền.
md5 ( partner_key + code + serial )		Chuỗi
commandĐiền chuỗi: chargingChuỗi
\n

Ví dụ:

\n
{\n    \"serial\": \"10009256840805\",\n    \"request_id\": \"353454r34tfd\",\n    \"telco\": \"VIETTEL\",\n    \"code\": \"018991216881305\",\n    \"amount\": \"10000\",\n    \"partner_id\": \"100006\",\n    \"sign\": \"428984b1652dce8b1d619185b8e20171\",\n    \"command\": \"charging\"\n}\n\n
\n

Apidoithe phản hồi khi gửi thẻ sang:

\n

Là một chuỗi Json chứa các tham số:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
StatusMô tả
99Gửi thẻ thành công, đợi xử lý chốc lát
Các status còn lại: Gửi thất bạiCó lý nội dung mô tả chi tiết trong mess trả về
\n

Ví dụ

\n

Thành công:

\n
{\n    \"status\": \"99\",\n    \"message\": \"Thẻ đã gửi thành công và đang chờ xử lý\",\n    \"trans_id\": \"VK2ezSzLkf\",\n    \"code\": \"018991216881304\",\n    \"serial\": \"10009256840804\",\n    \"telco\": \"VIETTEL\",\n    \"declared_value\": 10000,\n    \"value\": null,\n    \"receive_amount\": null,\n    \"request_id\": \"353454r34tfd\",\n    \"sign\": \"64f951693d608c43dc1d05cb70508f60\"\n}\n\n
\n

Thất bại:

\n
{\n    \"status\": \"-32\",\n    \"message\": \"Error: Mã 018991216881304, seri 10009256840804 đã tồn tại. Và đang ở trạng thái: failed\"\n}\n\n
\n","urlObject":{"protocol":"https","path":["chargingws","v2"],"host":["apidoithe","com"],"query":[],"variable":[]}},"response":[{"id":"d070f935-cb9a-43b3-84e6-899791fb9e74","name":"Gửi thẻ cào sang apidoithe.com","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"serial\": \"10009256840805\",\r\n \"request_id\": \"353454r34tfd\",\r\n \"telco\": \"VIETTEL\",\r\n \"code\": \"018991216881305\",\r\n \"amount\": \"10000\",\r\n \"partner_id\": \"100006\",\r\n \"sign\": \"428984b1652dce8b1d619185b8e20171\",\r\n \"command\": \"charging\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://apidoithe.com/chargingws/v2"},"status":"OK","code":200,"_postman_previewlanguage":"html","header":[{"key":"Date","value":"Wed, 07 Dec 2022 10:05:38 GMT"},{"key":"Content-Type","value":"text/html; charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"cache-control","value":"no-store, no-cache, must-revalidate"},{"key":"pragma","value":"no-cache"},{"key":"vary","value":"Accept-Encoding"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=w7qqkzzimzV2bAWLNccUZnqrlVK6c944tKpKgScNCidFX50fwzTrgnbMmo3Mia6Qt42k5DaHxbC0U671stSBBgRbDg%2BYq3zhzGr1LHjzbcV5%2FyL7iFEvIfxWQiJqBfWw\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"775c71a40df704cf-HKG"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\"status\":\"99\",\"message\":\"Th\\u1ebb \\u0111\\u00e3 g\\u1eedi th\\u00e0nh c\\u00f4ng v\\u00e0 \\u0111ang ch\\u1edd x\\u1eed l\\u00fd\",\"trans_id\":\"YvTs2I0J2A\",\"code\":\"018991216881305\",\"serial\":\"10009256840805\",\"telco\":\"VIETTEL\",\"declared_value\":10000,\"value\":null,\"receive_amount\":null,\"request_id\":\"353454r34tfd\",\"sign\":\"428984b1652dce8b1d619185b8e20171\"}"}],"_postman_id":"ce131965-4d3f-4285-aacb-0b8799bd1149"},{"name":"Callback gọi lại sang bên bạn bằng Json","id":"468d341a-1ed6-4e82-999e-065e2577a7fb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":""},"url":"https:// link callback mà bạn gắn trên apidoithe","description":"

Bạn nhận callback kết quả xử lý thẻ từ chúng tôi bằng phương thức POST hoặc GET tùy theo bạn muốn (cấu hình khi gắn link callback ở mục Kết nối API.

\n

Dữ liệu được gửi sang dạng chuỗi Json bao gồm:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Tên tham sốGiải thích
status1 là thành công
2 là thẻ sai mệnh giá
3 là thẻ lỗi, nạp thất bại
messageTin nhắn mô tả cho trạng thái thẻ
request_idID tùy ý tạo và lưu lại phía bên bạn, để khi có kết quả đổi thẻ, sẽ trả kèm dữ liệu kết quả, mục đích phân biệt thẻ khi bạn cần cập nhật trạng thái thẻ bên bạn.
trans_idID thẻ trên dữ liệu của chúng tôi
declared_valueMệnh giá bên bạn khai báo
valueMệnh giá thực của thẻ kiểm tra được sau khi xử lý
amountSố tiền bạn được cộng trên web đổi thẻ
serialSeri của thẻ cào
codeMã của thẻ cào
telcoNhà mạng của thẻ.
Bao gồm: VIETTEL, MOBIFONE, VINAPHONE, VNMOBI, ZING, GATE
amountMệnh giá thẻ cào khách khai báo
partner_idPartner ID này lấy tại mục kết nối API
callback_signChữ ký mà bạn gửi sang để so khớp với bên bạn nhằm mục đích bảo mật.
(Là kết quả sau khi mã hóa MD5 của chuỗi partner_key, code và serial nối liền.
md5 ( partner_key + code + serial ) )
\n

Ví dụ:

\n
{\n\"status\":1,\n\"message\":\"Th\\u00e0nh c\\u00f4ng\",\n\"request_id\":\"989876\",\n\"declared_value\":50000,\n\"value\":50000,\n\"amount\":25000,\n\"code\":\"314688440422676\",\n\"serial\":\"10003395125761\",\n\"telco\":\"VIETTEL\",\n\"trans_id\":54180,\n\"callback_sign\":\"17b118fe86852c52ea126c9537617f6d\"\n}\n\n
\n","urlObject":{"protocol":"https","host":[" link callback mà bạn gắn trên apidoithe"],"query":[],"variable":[]}},"response":[],"_postman_id":"468d341a-1ed6-4e82-999e-065e2577a7fb"},{"name":"Ver 3: Lấy chiết khấu theo thời gian thực","id":"0920eb45-e70e-46d2-b50d-ff5b843825d4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://apidoithe.com/api/discount?partner_id=100005","description":"

Bạn có thể lựa chọn theo cách v2 bên dưới hoặc cách v3 này:
Thay tham số partner_id thành partner id của bạn.
Ví dụ bên trên partner_id là 100005.

\n

Kết quả trả về là một chuỗi json. Bạn lấy giá trị của nhà mạng và mệnh giá thẻ tương ứng để sử dụng.

\n","urlObject":{"protocol":"https","path":["api","discount"],"host":["apidoithe","com"],"query":[{"key":"partner_id","value":"100005"}],"variable":[]}},"response":[{"id":"94e5226d-eb0e-4bc1-9288-9a9e00722098","name":"Lấy chiết khấu theo thời gian thực","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://apidoithe.com/api/discount?partner_id=100005","protocol":"https","host":["apidoithe","com"],"path":["api","discount"],"query":[{"key":"partner_id","value":"100005"}]}},"status":"OK","code":200,"_postman_previewlanguage":"html","header":[{"key":"Date","value":"Sun, 25 Dec 2022 18:10:59 GMT"},{"key":"Content-Type","value":"text/html; charset=UTF-8"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"set-cookie","value":"PHPSESSID=4o9oop7gpsibgu361b20ha94g6; path=/"},{"key":"expires","value":"Thu, 19 Nov 1981 08:52:00 GMT"},{"key":"cache-control","value":"no-store, no-cache, must-revalidate"},{"key":"cache-control","value":"no-cache, private"},{"key":"pragma","value":"no-cache"},{"key":"x-ratelimit-limit","value":"60"},{"key":"x-ratelimit-remaining","value":"60"},{"key":"access-control-allow-origin","value":"*"},{"key":"vary","value":"Accept-Encoding"},{"key":"CF-Cache-Status","value":"DYNAMIC"},{"key":"Report-To","value":"{\"endpoints\":[{\"url\":\"https:\\/\\/a.nel.cloudflare.com\\/report\\/v3?s=g%2FYx4EFbmKIE626a%2FqIiD1r5HOKSGKMjAqr8ezgHKJssWyQR%2FjYR9c9faaIHlV6WrcU5ycwfKv0977lhQu%2FDylA7pISFxlOPOy10OwkcG5DkjKCcV5AM%2B5ha%2B%2FcFJ3nb\"}],\"group\":\"cf-nel\",\"max_age\":604800}"},{"key":"NEL","value":"{\"success_fraction\":0,\"report_to\":\"cf-nel\",\"max_age\":604800}"},{"key":"Server","value":"cloudflare"},{"key":"CF-RAY","value":"77f389639aa320e1-HKG"},{"key":"Content-Encoding","value":"br"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400, h3-29=\":443\"; ma=86400"}],"cookie":[],"responseTime":null,"body":"{\"VIETTEL\":{\"10\":17,\"20\":17,\"30\":17,\"50\":16,\"100\":16,\"200\":16,\"300\":16,\"500\":19,\"1000\":19},\"MOBIFONE\":{\"10\":19,\"20\":19,\"30\":19,\"50\":19,\"100\":19,\"200\":19,\"300\":19,\"500\":19,\"1000\":19},\"VINAPHONE\":{\"10\":12,\"20\":12,\"30\":12,\"50\":12,\"100\":12,\"200\":15,\"300\":12,\"500\":12,\"1000\":13},\"VNMOBI\":{\"10\":17,\"20\":17,\"30\":17,\"50\":17,\"100\":17,\"200\":17,\"300\":17,\"500\":17,\"1000\":17},\"ZING\":{\"10\":17,\"20\":17,\"30\":17,\"50\":17,\"100\":17,\"200\":17,\"300\":17,\"500\":17,\"1000\":17},\"GATE\":{\"10\":26,\"20\":26,\"30\":26,\"50\":26,\"100\":26,\"200\":26,\"300\":26,\"500\":26,\"1000\":26}}"}],"_postman_id":"0920eb45-e70e-46d2-b50d-ff5b843825d4"}]}