API Tra Cứu Giao Dịch

POST /apitelco/search

Headers

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

Body

Json

Request Body

{
    "transRef": "efc30364-5964-413b-a170-1a2581549e14",
    "transDate":"2024-08-08",
    "signature":"70674d527c069ac4ca5c46926eeb93cd"
}

Giải thích các field

Name	Type	Bắt Buộc	Description
transDate	string	Yes	Ngày tháng của giao dịch theo format Y-m-d . Ví dụ 2024-08-08
transRef	string	Yes	Mã Giao Dịch đã gửi lên hệ thống
signature	string	Yes	Chữ ký số được dựng theo quy tắc md5(transRef+transDate) . ví dụ với giao dịch trên signature = md5efc30364-5964-413b-a170-1a2581549e142024-08-08)cho ra kết quả : 70674d527c069ac4ca5c46926eeb93cd

Code ví dụ

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://domain.com/apitelco/search',
  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 =>'{
    "transRef": "efxxx",
    "transDate":"2024-08-08",
    "signature":"70674d527c069ac4ca5c46926eeb93cd"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'api-key: xxx'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Python

cUrl

Response

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

Gạch Thành công

{
    "status": 2,
    "price": "100000",
    "description": "Transaction successful",
    "transRef": "efc30364-5964-413b-a170-1a2581549e14",
    "data": {
        "partnerName": "xxx",
        "cardSerial": "100006000010433",
        "cardCode": "106816433533",
        "note": "Thành công",
        "phone": "090xxxx",
        "topupTime": "2024-08-08 16:47:03",
        "createdTime": "2024-08-08 16:47:03"
    }
}

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
data	strimg	Json chứa các thông tin của thẻ cào "data": { "partnerName": "xxx", "cardSerial": "100006000010433", "cardCode": "106816433533", "note": "Thành công", "phone": "090xxxx", "topupTime": "2024-08-08 16:47:03", "createdTime": "2024-08-08 16:47:03" }