Đăng ký Đăng nhập

Hướng dẫn tích hợp API

21:07
20/01/2021
2121

Hướng dẫn tích hợp API thanh toán thẻ cào tự động, Dành cho các website mua bán, Shop game, Dịch vụ facebook, Các cổng thương mại điện tử,.....

Tích hợp api thẻ cào

 

1. Giới thiệu

Doithengay.com là cổng gạch thẻ cào trực tuyến, hỗ trợ đa dạng với các nhà mạng như: Viettel, Vinaphone, Mobifone, hoặc VNMB. Cho phép người dùng tích hợp API nhanh chóng, dễ dàng trên website và ứng dụng

2. Đăng ký tài khoản & partner_id và partner_key

Nếu bạn chưa có tài khoản, vui lòng đăng ký tại https://doithengay.com/account/register. Sau khi đã có tài khoản, Để có thông tin partner_id và partner_key, Bạn chọn mục kết nối API và điền môt số thông tin để yêu cầu tạo API.

api đổi thẻ cào

Bạn nhập thông tin: Tên mô tả API, Kiểu (POST, GET). Link đường dẫn Callback muốn nhận kết quả. Và bấm thêm thông tin.

* Sau đó bạn liên hệ với Admin web doithengay.com để được hỗ trợ kích hoạt API.

 

3. Gửi thẻ nạp

Để gửi dữ liệu nạp thẻ lên hệ thống bạn gửi request đến https://doithengay.com/chargingws/v2 với phương thức POST.

* Gồm những thông tin sau

telco

Mã nhà mạng. Do Doithengay.com cấp

Bắt buộc

code

Mã nạp

Bắt buộc

serial

Seri thẻ

Bắt buộc

amount

Mệnh giá thẻ

Bắt buộc

partner_id

Mã kết nối api lấy trên website Doithengay.com

Bắt buộc

sign

Mã hóa bảo mật

Bắt buộc

command

Lệnh

Bắt buộc

request_id

Mã đơn hàng của bên bạn

bắt buộc

 

Telco có định dạng như sau: Vui lòng gửi đúng định dạng in hoa.

Mã khóa Nhà mạng
VIETTEL thẻ viettel
MOBIFONE thẻ mobifone
VINAPHONE thẻ vinaphone
ZING thẻ zing
GARENA thẻ garena
GATE thẻ gate
VCOIN thẻ vcoin

 

Ví dụ thông tin gửi lên như sau:

$datapost['telco'] = 'VIETTEL';

$datapost['code'] = '9999999999999';

$datapost['serial'] = '6666666666';

$datapost['amount'] = '100000';

$datapost['request_id'] = '1234';

$datapost['partner_id'] = '15857545515';

$datapost['command'] = 'charging';

$datapost['sign'] = '34fkdsjhgdsfl34238dfdjh34dfd2e';

 

 

Lưu ý command là lệnh gửi đến hệ thống

Đổi thẻ -> command = charging

Check thẻ -> command = check

Sau khi gửi lên thành công, hệ thống sẽ trả về cho bạn kết quả ở dạng Json như sau:

stdClass Object

(

    [status] => 99

    [message] => Thẻ đã gửi thành công và đang chờ xử lý

    [code] => 9999999999999

    [serial] => 10001796141928

    [telco] => VIETTEL

    [declared_value] => 100000

    [value] =>

    [receive_amount] =>

    [request_id] => 817633220

    [trans_id] => 64

    [sign] =>

)

declared_value : là mệnh giá bạn khai báo cho chúng tôi

value: là mệnh giá thực mà chúng tôi kiểm tra được

3 Các trạng thái

Ở đây chỉ đưa ra các trạng thái chính, còn các trạng thái khác là thông báo lỗi.   

Status

            ///99 = CHỜ

    /// 1 = THẺ ĐÚNG

    /// 2 = THẺ SAI MỆNH GIÁ

    /// 3 = THẺ LỖI

    /// 4 = BẢO TRÌ

- Mẫu log thực tế các trạng thái:

+ Thẻ chờ:

{"status":99,"message":"Th\u1ebb \u0111ang ch\u1edd x\u1eed l\u00fd","request_id":"43950","declared_value":20000,"value":null,"amount":12600,"code":"816815546262524","serial":

"10002136142286","telco":"VIETTELAUTO","trans_id":269767,"callback_sign":"1974535b6f38716f49b1cc3d1bed1b9c"}

+ Thẻ đúng:

{"status":1,"message":"Th\u1ebb \u0111\u00fang","request_id":"32051","declared_value":50000,"value":50000,"amount":36500,"code":"614874611547206",

"serial":"10001197841955","telco":"VIETTELAUTO","trans_id":269752,"callback_sign":"1ddeae26472328327ed7ef944be34daf"}

+ Thẻ sai mệnh giá: Khai mệnh giá 20k, thực tê mệnh giá 10k

{"status":2,"message":"Th\u1ebb sai m\u1ec7nh gi\u00e1","request_id":"890676711","declared_value":20000,"value":"10000","amount":4410,"code":"716527274724352",

"serial":"10003945623426","telco":"VIETTELAUTO","trans_id":269629,"callback_sign":"1fd0f2b14ff39e612ee411b4968df077"}

+ Thẻ lỗi: Là mã thẻ sai hoặc đã sử dụng

{"status":3,"message":"Th\u1ebb l\u1ed7i","request_id":"75860","declared_value":50000,"value":0,"amount":0,"code":"213220993383378",

"serial":"10002043319423","telco":"VIETTELAUTO","trans_id":269627,"callback_sign":"bfcb25c8e10844ee98bbad4a48ba24f5"}

+ Bảo trì: lỗi hệ thống hoặc nhà mạng lỗi

{"status":4,"message":"B\u1ea3o tr\u00ec","request_id":"355498359","declared_value":50000,"value":0,"amount":0,"code":"940210495104805",

"serial":"10004940041805","telco":"VIETTELAUTO","trans_id":269781,"callback_sign":"32452065db9c2099aa7376386d91d3d0"}

Hệ thống cung cấp cho bạn một tiện ích trả kết quả tẩy thẻ thông qua hình thức POST. Sau khi admin xử lý thẻ thành công, hệ thống sẽ post thông tin kết quả về website của bạn gồm các dữ liệu như sau:

        array(

            'status'] = 1;

            'message'] = 'Thẻ đúng',

            'value'] =  '100000',

            'amount'] = '65000',

            'code'] = '76532234',

            'serial'] = '123567',

             'request_id' = '324234',

            'telco'] = 'VIETTEL',

        )

5. Callback

Mục tạp API đã có mục thêm link callback của bạn sau khi tạo, Nếu muốn thay đổi link hay liên hệ bộ phận kỹ thuật của chúng tôi. Ví dụ: http://websitecuaban.com/callback.php

callback_sign là chữ ký xác nhận chính chủ được nhận kết quả. Cách tạo sign đã có hướng dẫn trong file code mẫu callback.php

+ Doithengay.com - Cung cấp dịch vụ API tích hợp thẻ cào, Cổng thanh toán thẻ cào ổn định nhất hiện nay, Api gạch thẻ, API đổi thẻ hỗ trợ nhiều loại thẻ .

Hệ thống hoạt động ổn định và tốc độ xử lý thẻ cào siêu nhanh, chính vị vậy khi bạn kết nối API gạch thẻ tới Doithengay.com bạn sẽ được sử dụng dịch vụ tuyệt vời nhất

Chiết khấu luôn tốt nhất thị trường, Khi bạn Tích hợp API thẻ cào tới website Doithengay.com bạn sẽ được hưởng những chiết khấu tốt nhất tùy vào sản lượng thẻ cào hàng ngày của bạn.

Hãy liên hệ ngay cho chúng tôi để được tư vấn và hỗ trợ.