Cek User ID Member

Sebelum melakukan tambah saldo atau kurangi saldo member, Anda harus mengambil data user_id member anda terlebih dahulu menggunakan nomor telepon atau email member.

GET https://api.tokoaja.com/member/saldo/cek_user_id

Shortcode yang tersedia:

{{app_id}} = username aplikasi

Parameter Cek User ID

Parameter	Type	Wajib	Keterangan
app	string	YA	Username aplikasi
nomor_hp	string	TIDAK	Nomor telepon member
email	string	TIDAK	Email member

Contoh Request Cek User ID (jQuery)


var app = "{{app_id}}";

$.ajax({

    url: "https://api.tokoaja.com/member/saldo/cek_user_id",
    method: "GET",

    data: {
        app: app,
        nomor_hp: "08123456789"
    },

    success: function(response){

        console.log(response);

    }

});

Contoh Response User ID

{
    "status": 200,
    "respon": "data ditemukan",
    "jumlah_data": 1,
    "data": [
        {
            "user_id": "USR12931",
            "nama": "Budi Santoso",
            "foto_profil": "https://cdn.tokoaja.com/foto/user.jpg"
        }
    ]
}

Tambah & Kurangi Saldo

Endpoint berikut digunakan untuk menambah saldo atau mengurangi saldo member menggunakan user_id.

POST https://api.tokoaja.com/member/saldo/ubah

Parameter Ubah Saldo

Parameter	Type	Wajib	Keterangan
app	string	YA	Username aplikasi
user_id	string	YA	ID user member
jumlah	integer	YA	Jumlah saldo
type	string	YA	tambah / kurang

Authorization Header

Ganti Text "API_KEY_APLIKASI_ANDA" dengan Screet API Key aplikasi anda

Authorization: Bearer API_KEY_APLIKASI_ANDA

Contoh Tambah Saldo (jQuery)


var app = "{{app_id}}";
var token = "API_KEY_APLIKASI_ANDA";

$.ajax({

    url: "https://api.tokoaja.com/member/saldo/ubah",
    method: "POST",

    headers: {
        Authorization: "Bearer " + token
    },

    data: {
        app: app,
        user_id: "USR12931",
        jumlah: 10000,
        type: "tambah"
    },

    success: function(response){

        console.log(response);

    }

});

Contoh Kurangi Saldo (PHP cURL)


<?php

$app = "{{app_id}}";
$token = "API_KEY_APLIKASI_ANDA";

$post = [

    "app" => $app,
    "user_id" => "USR12931",
    "jumlah" => 5000,
    "type" => "kurang"

];

$ch = curl_init();

curl_setopt_array($ch,[

    CURLOPT_URL => "https://api.tokoaja.com/member/saldo/ubah",
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($post),
    CURLOPT_RETURNTRANSFER => true,

    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer ".$token
    ]

]);

$response = curl_exec($ch);

curl_close($ch);

echo $response;

?>

Contoh Response Sukses

{
    "status": 200,
    "respon": "saldo berhasil ditambah",
    "nama_user": "Budi Santoso",
    "type": "tambah",
    "jumlah": 10000,
    "saldo_awal": 25000
}

Error Response

data tidak valid

{
    "respon": "data tidak valid"
}

Error ini muncul jika parameter app, user_id, type, atau Authorization Bearer tidak dikirim.

app tidak ditemukan

{
    "respon": "app tidak ditemukan"
}

Error ini muncul jika username aplikasi tidak ditemukan di server.

user_id tidak ditemukan

{
    "respon": "user_id tidak ditemukan"
}

Error ini muncul jika user_id member tidak ditemukan.

api key salah

{
    "respon": "api key salah"
}

Error ini muncul jika Authorization Bearer API Key salah atau tidak valid.

saldo gagal dikurangi

{
    "status": false,
    "respon": "gagal - jumlah saldo yang akan dikurangi lebih besar dari saldo user sekarang",
    "nama_user": "Budi Santoso",
    "type": "kurang",
    "jumlah": 50000,
    "saldo_awal": 10000
}

Error ini muncul jika jumlah saldo yang akan dikurangi lebih besar dibanding saldo member saat ini.

Tokoaja API