Dokumentasi API SecretCryptos

Status Pesanan

Gunakan satu endpoint untuk memeriksa status pesanan mixer dan exchange. Anda dapat secara eksplisit menetapkan jenis pesanan (mixer/exchange) atau membiarkan API mendeteksinya secara otomatis.

Endpoint

Badan Permintaan

• trackcode(wajib): Kode pelacakan 16 karakter huruf besar dari pesanan.
• type(opsional): mixer | exchange. Jika tidak diisi, API akan mencoba mendeteksi secara otomatis.
• outputs(opsional): none | summary | full (default: summary).
• mask_addresses(opsional): true=alamat disembunyikan (default), false=kembalikan alamat penuh.

Respons

• type: mixer atau exchange.
• deposit.confirm_status: Status konfirmasi deposit:
  • 0: Tidak ada pembayaran diterima.
  • 1: Pembayaran diterima tetapi masih tertunda (menunggu konfirmasi atau belum sepenuhnya terdanai).
  • 2: Deposit sepenuhnya dikonfirmasi dan terdanai.
• deposit.delete_in_sec: Sisa detik hingga kedaluwarsa retensi 48 jam.
• Blok deposit.funding:
  • waiting_balance: Jumlah total yang diharapkan.
  • received_balance: Jumlah yang sudah diterima.
  • remaining_need: Jumlah yang masih dibutuhkan.
  • is_fully_funded: Apakah sudah sepenuhnya terdanai.
  • can_start: hanya true jika confirm_status==2 DAN is_fully_funded==true.
• outputs:
  • none: Tidak dikembalikan.
  • summary: Mengembalikan count, sent_count, sent_total.
  • full: Untuk setiap output: index, address (disembunyikan atau tidak), destination_tag, coin, network, share_percent, delay_label, delay_seconds, state, confirm, tx, amount, left_seconds.
• status_reason: misalnya "INSUFFICIENT_FUNDS" (jika belum sepenuhnya terdanai).

Aturan Bisnis

• Pesanan tidak akan dimulai kecuali sepenuhnya terdanai (is_fully_funded=false): output tetap tidak ditugaskan dan tidak ada pembayaran afiliasi yang dihasilkan.
• Jika confirm_status==2 DAN is_fully_funded==true:
  • Output diberi stempel waktu sekali dan tetap konsisten pada pemeriksaan berulang.
  • Pendapatan afiliasi dikreditkan satu kali saat pesanan menjadi valid.

Contoh Permintaan (PHP)

// Contoh Mixer (output penuh, alamat tidak disembunyikan)<?php
$url = "https://api.secretcryptos.com/v1/orders/check";

$headers = [
  "Authorization: Bearer <API_KEY>",
  "Content-Type: application/json"
];

$data = [
  "trackcode"      => "554FEC10054743FD",
  "type"           => "mixer",     // mixer | exchange
  "outputs"        => "full",      // none | summary | full
  "mask_addresses" => false        // true(default)=masked, false=full
];

$ch = curl_init($url);
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => $headers,
  CURLOPT_POST           => true,
  CURLOPT_POSTFIELDS     => json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
]);

$result = curl_exec($ch);

if ($result === false) {
  header("Content-Type: text/plain; charset=utf-8");
  echo "cURL error: " . curl_error($ch);
} else {
  header("Content-Type: application/json; charset=utf-8");
  echo $result;
}
curl_close($ch);

Contoh Respons — Sepenuhnya Terdanai

{
  "ok": true,
  "type": "mixer",
  "trackcode": "6A5FB3BA8A150EC9",
  "deposit": {
    "confirm_status": 2,
    "coin": "btc",
    "network": "btc",
    "delete_in_sec": 167812,
    "funding": {
      "waiting_balance": "10.00000000",
      "received_balance": "10.00000000",
      "remaining_need": "0.00000000",
      "is_fully_funded": true,
      "can_start": true
    }
  },
  "outputs": [
    {
      "index": 1,
      "address": "35iMHbUZeTssxBodiHwEEkb32jpBfVueEL",
      "destination_tag": null,
      "coin": "btc",
      "network": "btc",
      "share_percent": 84.93,
      "delay_label": "0h 0m",
      "delay_seconds": 0,
      "state": 2,
      "confirm": 1,
      "tx": "135f451af7f894....fafb578eee9e9c4",
      "amount": "8.45469657",
      "left_seconds": 0
    },
    {
      "index": 2,
      "address": "1P279UBChDFPAky8S4DcKGaaxKEMYBK9MM",
      "destination_tag": null,
      "coin": "btc",
      "network": "btc",
      "share_percent": 15.07,
      "delay_label": "2h 0m",
      "delay_seconds": 7200,
      "state": 1,
      "confirm": 0,
      "tx": "",
      "amount": "1.50020343",
      "left_seconds": 5916
    }
  ]
}

Contoh Respons — Kurang Dana

{
  "ok": true,
  "type": "exchange",
  "trackcode": "A1B2C3D4E5F6A7B8",
  "deposit": {
    "confirm_status": 2,
    "coin": "usdt",
    "network": "erc20",
    "delete_in_sec": 14321,
    "funding": {
      "waiting_balance": "500.00000000",
      "received_balance": "420.00000000",
      "remaining_need": "80.00000000",
      "is_fully_funded": false,
      "can_start": false
    }
  },
  "status_reason": "INSUFFICIENT_FUNDS",
  "outputs": {
    "count": 3,
    "sent_count": 0,
    "sent_total": "0.00000000"
  }
}

Penjelasan Output

• index: Nomor urut output dalam pesanan.
• address: Alamat tujuan tempat dana dikirim.
• destination_tag: Tag/memo opsional untuk XRP, XLM, dll. (null jika tidak diperlukan).
• coin: Kode mata uang kripto untuk output (misalnya, btc, eth).
• network: Nama jaringan yang digunakan untuk transfer (misalnya, btc, eth).
• share_percent: Persentase dari total deposit yang ditugaskan ke output ini.
• delay_label: Label yang mudah dibaca menunjukkan kapan output ini akan diproses (misalnya, 2h 0m).
• delay_seconds: Waktu tunda dalam detik hingga output dapat mulai diproses.
• state: Status output:
  • 0 → Menunggu (deposit belum sepenuhnya dikonfirmasi).
  • 1 → Sedang diproses (dijadwalkan; dimulai saat delay_seconds mencapai 0).
  • 2 → Selesai (transfer selesai).
• confirm: Status konfirmasi transfer (hanya relevan pada state=2):
  • 0 → Transaksi disiarkan tetapi belum dikonfirmasi (tertunda).
  • 1 → Transaksi dikonfirmasi (setidaknya 1 konfirmasi blockchain).
• tx: Hash transaksi blockchain untuk output ini.
• amount: Jumlah yang dikirim ke alamat output ini.
• left_seconds: Sisa detik hingga waktu pengiriman terjadwal.
  Catatan: Hitungan mundur ini dimulai ulang setelah deposit.confirm_status=2 (sepenuhnya dikonfirmasi). Contoh: jika ditetapkan 600 detik (10 menit), hitungan mundur hanya dimulai setelah konfirmasi deposit.

Catatan: Data pembayaran dan output diperbarui setiap ~1 menit.

Kode Kesalahan

• BAD_REQUEST: trackcode hilang/tidak valid, badan permintaan rusak.
• NOT_FOUND: Pesanan tidak ditemukan.
• UNAUTHORIZED / FORBIDDEN: Kunci API tidak valid atau dinonaktifkan.
• TOO_MANY_REQUESTS: Batas permintaan harian terlampaui.
• SERVER_ERROR: Kesalahan server yang tidak terduga.

• mask_addresses: dikendalikan oleh mask_addresses (default: true).
• delay_seconds: setara numerik dari delay_label (hanya dikembalikan dalam mode full).