API NẠP THẺ NHANH

Api duy nhất trên thị trường gạch thẻ trực tiếp ngay trong 1 giao dịch với thời gian xử lý <1s

Hiện tại hoạt động với nhà mạng Mobifone

Sequent Diagram

Để kết nối đối tác cần cung cấp các thông tin sau để tiến hành kết nối :

Thông tin	Giải thích
IP	IP để kết nối API và truy cập được Dashboard

Các thông tin được cung cấp

Thông tin	Tác dụng
URI endpoint	Địa chỉ Api Endpoint để kết nối
Api-Key	Api key để xác thực request
CMS tra cứu	Link và Account tra cứu đối soát trên cms

Api Gạch thẻ

POST /apitelco/input

Api gạch thẻ trực tiếp vào đơn hàng ( sdt ) ngay trong 1 giao dịch với thời gian xử lý <1s

Headers

Name	Value
Content-Type	application/json
Api-Key	Api được cấp riêng cho đối tác

Body

Json

Request Body

{
    "cardCode": "565326285002",
    "cardSerial": "121312000003011",
    "issuer": "VMS",
    "transRef": "vs_8222d211",
    "price": "10000",
    "phone":"0904123123",
    "signature":"23ab49fe503e27ad3134e436d5347374"
}

Giải thích các field

Name	Type	Bắt Buộc	Description
cardCode	string	Yes	Mã Thẻ cào
cardSerial	string	Yes	Serial Thẻ Cào
issuer	string	Yes	Mã nhà mạng.(xem thêm bảng mã nhà mạng)
phone	string	Yes	Số điện thoại được nạp tiền . Có thể bị giới hạn số lần nạp thẻ tùy theo nhà mạng và loại thuê bao . ( xem chi tiết )
transRef	string	Yes	Mã Giao Dịch để đối soát và tracking (unique)
signature	string	Yes	Chữ ký số được dựng theo quy tắc md5(cardCode+cardSerial+issuer+phone+transRef) . ví dụ với giao dịch trên signature = md5(565326285002121312000003011VMS0904123123vs_8222d211)cho ra kết quả : 23ab49fe503e27ad3134e436d5347374
price	string	Optional	Mệnh giá thẻ

Code ví dụ

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://domain.com/apitelco/input',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "cardCode": "481628506557",
    "cardSerial": "12131201343011",
    "issuer": "VMS",
    "transRef": "vs_82222d2112",
    "price": "10000",
    "phone":"0904123123",
    "signature":"23ab49fe503e27ad3134e436d5347374"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Api-Key: xxx'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $respon

Python

cUrl

Response

Kết quả trả về là JSON

Gạch Thành công

{
    "status": 2,
    "amount": 10000,
    "description": "Thành công",
    "transRef": "vs_8222d2112"
}

Thất Bại

Lỗi khác

Miêu tả các Field Json Trả về :

Field	Kiểu Dữ Liệu	Giải Thích
status	string	Mã trạng thái giao dịch (xem thêm tại Phụ Lục 1)
description	string	Miêu tả
transRef	string	mã giao dịch
amount	int	giá thẻ nếu gạch thành công