Referensi API

Integrasikan Anythink Pay ke aplikasi Anda. REST API ini untuk menerima pembayaran, mengirim payout ke rekening bank, dan menerima notifikasi webhook secara real-time.


Autentikasi

Setiap request diautentikasi dengan Access Key dan Secret Key di header HTTP. Buat kedua key ini di dashboard merchant.

Base URL
https://www.snacknfrozen.com/api/live

Semua path endpoint di bawah relatif terhadap base URL ini, misalnya Buat PayIn adalah POST https://www.snacknfrozen.com/api/live/transactions.

Header
X-Access-Key: <your_access_key>
X-Secret-Key: <your_secret_key>

POST

Buat PayIn

https://www.snacknfrozen.com/api/live/transactions

Membuat pembayaran untuk pelanggan Anda. Semua metode pembayaran memakai endpoint yang sama; payment_method_code menentukan metodenya. Setiap metode di bawah punya contoh request dan response sendiri.

Metodepayment_method_codeMata uangYang ditampilkan ke pelanggan
QRISqrisIDRQR dari qr_content
Virtual Accountbca_va, mandiri_va, …IDRva_number
AlipayalipayCNYpayment_url atau gambar QR
Kartu Bank ChinacardCNYpayment_url atau rekening bank

Field umum

FieldKeterangan
payment_method_code *Metode pembayaran, lihat tabel di atas
invoice_number *ID unik dari sistem Anda untuk pembayaran ini
amount *Nominal dalam mata uang metode tersebut (lihat tiap metode)
currency IDR atau CNY; default mengikuti mata uang metode
description Ditampilkan di dashboard dan di callback

Semua metode mengembalikan objek transaction dengan status pending dan sebuah reference. Hasil akhirnya dikirim lewat callback (completed atau failed); Anda juga bisa memakai Cek Status.


POST

PayIn: QRIS

https://www.snacknfrozen.com/api/live/transactionspayment_method_code qris · IDR

Mengembalikan string QRIS di qr_content. Tampilkan sebagai kode QR; bisa dibayar dari aplikasi bank atau e-wallet Indonesia mana pun. QR berlaku 30 menit, setelah itu pembayaran menjadi expired.

FieldKeterangan
amount *Dalam rupiah. Akun yang dilayani provider SATRUN minimal 10000; nominal di bawahnya mendapat 400.
currency IDR
Request
{
  "payment_method_code": "qris",
  "invoice_number": "INV-2024-001",
  "amount": 100000,
  "currency": "IDR",
  "description": "Payment for order #123"
}
Response
{
  "transaction": {
    "invoice_number": "INV-2024-001",
    "amount": 100000,
    "currency": "IDR",
    "transaction_type": "credit",
    "credit_amount": 100000,
    "fee_amount": 1000,
    "net_amount": 99000,
    "status": "pending",
    "reference": "ORD-1705312200000-ABC12345",
    "description": "Payment for order #123",
    "payment_method": {
      "code": "qris",
      "name": "QRIS",
      "type": "QRIS",
      "provider": "NOBU"
    },
    "qr_content": "00020101021226650013ID.CO.QRIS.WWW...",
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:00:00Z"
  }
}

payment_method.provider menunjukkan provider yang membuat QR (NOBU, ASTERI, atau SATRUN). Provider ditentukan per akun, jadi selalu kirim qris dan tampilkan qr_content dengan cara yang sama.


POST

PayIn: Virtual Account

https://www.snacknfrozen.com/api/live/transactionspayment_method_code <bank>_va · IDR

Mengembalikan nomor virtual account di va_number yang ditransfer pelanggan dari banknya. Pakai kode bank, misalnya bca_va, mandiri_va, bri_va, atau bni_va.

FieldKeterangan
payment_method_code *misalnya mandiri_va (va_mandiri juga diterima)
amount *Dalam rupiah
Request
{
  "payment_method_code": "mandiri_va",
  "invoice_number": "INV-2024-002",
  "amount": 50000,
  "currency": "IDR",
  "description": "Payment for order #456"
}
Response
{
  "transaction": {
    "invoice_number": "INV-2024-002",
    "amount": 50000,
    "currency": "IDR",
    "transaction_type": "credit",
    "credit_amount": 50000,
    "fee_amount": 500,
    "net_amount": 49500,
    "status": "pending",
    "reference": "ORD-1705312200000-XYZ67890",
    "description": "Payment for order #456",
    "payment_method": {
      "code": "mandiri_va",
      "name": "Virtual Account - MANDIRI",
      "type": "VA",
      "provider": "MANDIRI"
    },
    "va_number": "889089999659407",
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:00:00Z"
  }
}

POST

PayIn: Alipay

https://www.snacknfrozen.com/api/live/transactionspayment_method_code alipay · CNY

Untuk pelanggan yang membayar dengan Alipay dalam yuan. Harus diaktifkan untuk akun Anda. Pembayaran masuk ke saldo CNY yang terpisah dan tidak pernah dikonversi ke IDR; fee CNY diatur terpisah.

Arahkan pelanggan ke payment_url, atau tampilkan gambar QR dari payment_instructions.qr_code_url di halaman Anda sendiri bila tersedia. Tidak ada batas waktu tetap: pembayaran berakhir completed atau failed.

FieldKeterangan
amount *Yuan bulat, tanpa desimal (misalnya 500)
currency CNY (default)
customer_name Nama pembayar, dikirim ke provider (disarankan)
customer_id ID pembayar dari sistem Anda
customer_ip Alamat IP pembayar; default IP request
Request
{
  "payment_method_code": "alipay",
  "invoice_number": "INV-CN-001",
  "amount": 500,
  "currency": "CNY",
  "customer_name": "Li Wei",
  "description": "Order #789"
}
Response
{
  "transaction": {
    "invoice_number": "INV-CN-001",
    "amount": 500,
    "currency": "CNY",
    "transaction_type": "credit",
    "credit_amount": 500,
    "fee_amount": 10,
    "net_amount": 490,
    "status": "pending",
    "reference": "ORD-1705312200000-ABC12345",
    "description": "Order #789",
    "payment_method": {
      "code": "alipay",
      "name": "Alipay",
      "type": "EWALLET",
      "provider": "ZEKAPAY"
    },
    "payment_url": "https://cashier.zekapay.com/v2/?orderNo=COL2025...",
    "payment_instructions": {
      "channel": "ALIPAY",
      "pay_amount": "500.00",
      "pay_currency": "CNY",
      "account_name": "Li Si",
      "bank_name": null,
      "branch": null,
      "account_number": null,
      "qr_code_url": "https://cdn.example.com/qr_code.png"
    },
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:00:00Z"
  }
}

payment_instructions bisa null; payment_url selalu ada.


POST

PayIn: Kartu Bank China

https://www.snacknfrozen.com/api/live/transactionspayment_method_code card · CNY

Untuk pelanggan yang membayar lewat transfer dari kartu bank China, dalam yuan. Harus diaktifkan untuk akun Anda. Seperti Alipay, dananya masuk ke saldo CNY.

Arahkan pelanggan ke payment_url, atau tampilkan rekening tujuan dari payment_instructions (account_name, bank_name, branch, account_number) di halaman Anda sendiri bila tersedia. Pelanggan harus mentransfer tepat sebesar pay_amount.

FieldKeterangan
amount *Yuan bulat, tanpa desimal (misalnya 1000)
currency CNY (default)
customer_name Nama pembayar, dikirim ke provider (disarankan)
customer_id ID pembayar dari sistem Anda
customer_ip Alamat IP pembayar; default IP request
Request
{
  "payment_method_code": "card",
  "invoice_number": "INV-CN-002",
  "amount": 1000,
  "currency": "CNY",
  "customer_name": "Wang Fang",
  "description": "Order #790"
}
Response
{
  "transaction": {
    "invoice_number": "INV-CN-002",
    "amount": 1000,
    "currency": "CNY",
    "transaction_type": "credit",
    "credit_amount": 1000,
    "fee_amount": 20,
    "net_amount": 980,
    "status": "pending",
    "reference": "ORD-1705312200000-DEF45678",
    "description": "Order #790",
    "payment_method": {
      "code": "card",
      "name": "China Bank Card",
      "type": "BANK_TRANSFER",
      "provider": "ZEKAPAY"
    },
    "payment_url": "https://cashier.zekapay.com/v2/?orderNo=COL2025...",
    "payment_instructions": {
      "channel": "BANK_ACCOUNT",
      "pay_amount": "1000.00",
      "pay_currency": "CNY",
      "account_name": "Zhang San",
      "bank_name": "Bank of China",
      "branch": "Shenzhen Branch",
      "account_number": "6222000012346789",
      "qr_code_url": null
    },
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:00:00Z"
  }
}

POST

Buat PayOut

https://www.snacknfrozen.com/api/live/transactions/transfer-out

Mengirim dana dari saldo IDR Anda ke rekening bank penerima. Transaksi ini dicatat sebagai debit.

Nominal ditambah fee tidak boleh melebihi saldo available (lihat Cek Saldo). Pada akun dengan payout otomatis, payout dengan bank yang dikenali langsung dipotong dan dikirim ke bank, dan response sudah berstatus processing. Tetap kirim kode bank seperti biasa di bank_account_code (misalnya 002 untuk BRI); Daftar Bank menunjukkan kode yang didukung. Selain itu, payout baru berstatus pending sampai disetujui; response-nya berisi note yang menjelaskan kenapa tidak dikirim otomatis. Payout yang disetujui dipotong dari saldo, lalu langsung selesai atau dikirim ke bank dan berstatus processing sampai bank mengonfirmasi. Hasil akhirnya dikirim lewat callback completed, atau failed dengan nominal dan fee dikembalikan ke saldo.

Body request

Request
{
  "invoice_number": "INV-OUT-2024-001",
  "amount": 50000,
  "currency": "IDR",
  "description": "Transfer out to merchant",
  "beneficiary_data": {
    "bank_account_name": "John Doe",
    "bank_account_number": "1234567890",
    "bank_account_code": "002"
  }
}
FieldKeterangan
amount *Nominal payout. Minimal 10000 (Rp 10.000); nominal di bawahnya mendapat 400. Fee ditambahkan di atas nominal ini.
beneficiary_data *Objek berisi data rekening
bank_account_name *Nama pemilik rekening
bank_account_number *Nomor rekening tujuan
bank_account_code *Kode bank Indonesia (misalnya 002 untuk BRI, 014 untuk BCA). Kode yang punya bank_code di Daftar Bank dikirim otomatis; kode lain menunggu persetujuan manual.
bank_id Opsional, menggantikan bank_account_code. Pakai bank_id dari Daftar Bank untuk tujuan tanpa kode bank, seperti e-wallet.
account_type Opsional: bank, va, atau ewallet. Default mengikuti jenis bank (nomor e-wallet diawali 08, 8, 628, atau 6208).

Response

200 OK
{
  "transaction": {
    "invoice_number": "INV-OUT-2024-001",
    "amount": 50000,
    "currency": "IDR",
    "transaction_type": "debit",
    "debit_amount": 50000,
    "fee_amount": 2500,
    "net_amount": 50000,
    "total_amount": 52500,
    "status": "processing",
    "reference": "WD-12345678",
    "description": "Transfer out to merchant",
    "beneficiary_data": {
      "bank_account_name": "John Doe",
      "bank_account_number": "1234567890",
      "bank_account_code": "002"
    },
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:00:00Z"
  }
}
400 Bad Request
{
  "error": "Minimum payout amount is 10000"
}

GET

Daftar Bank

https://www.snacknfrozen.com/api/live/banks

Bank dan e-wallet yang bisa menerima payout otomatis. Kirim bank_code sebagai bank_account_code di Buat PayOut, atau bank_id jika bank_code bernilai null (misalnya e-wallet). Memakai header API key yang sama. Daftar ini jarang berubah; simpan di sisi Anda.

200 OK
{
  "banks": [
    { "bank_code": "014", "bank_id": 6, "bank_name": "BCA", "type": "bank" },
    { "bank_code": null, "bank_id": 165, "bank_name": "DANA", "type": "ewallet" }
  ]
}

POST / GET

Cek Status Transaksi

https://www.snacknfrozen.com/api/live/transactions/:id/check-status

Mengembalikan status terkini sebuah PayIn atau PayOut. Ganti :id dengan reference atau invoice_number transaksi. POST dan GET sama-sama diterima dengan perilaku yang sama, memakai header API key yang sama. Tidak perlu body request. Jika satu invoice number dipakai lebih dari sekali, yang dikembalikan transaksi terbaru, jadi sebaiknya pakai reference.

Nilai status

StatusKeterangan
pending Menunggu pembayaran, atau PayOut menunggu persetujuan
processing PayOut sudah disetujui dan dipotong, transfer sedang diproses bank
succeeded Sudah dibayar atau ditransfer, dengan is_paid bernilai true. Di callback, status ini dikirim sebagai completed.
failed Pembayaran gagal atau dibatalkan, atau transfer ditolak atau gagal (nominal dan fee dikembalikan ke saldo)
expired PayIn kedaluwarsa tanpa dibayar
disputed PayIn yang sudah dibayar sedang didispute (dananya ditahan), atau transfer PayOut yang sudah disetujui sedang diperiksa
refunded Dispute diputus tidak menguntungkan; PayIn dikembalikan ke pembayar

Response

200 OK
{
  "success": true,
  "is_paid": true,
  "updated": false,
  "status": "succeeded",
  "reference": "ORD-1705312200000-ABC12345",
  "invoice_number": "INV-2024-001",
  "direction": "in",
  "message": "Transaction has succeeded."
}
200 OK (pengecekan ke provider gagal)
{
  "success": false,
  "is_paid": false,
  "status": "pending",
  "reference": "ORD-1705312200000-ABC12345",
  "invoice_number": "INV-2024-001",
  "direction": "in",
  "message": "Failed to check the status with the provider",
  "error": "Provider status check failed"
}
404 Not Found
{
  "error": "Transaction not found"
}

GET

Cek Saldo

https://www.snacknfrozen.com/api/live/balance

Mengembalikan saldo merchant Anda, memakai header X-Access-Key dan X-Secret-Key yang sama. Ada satu entri per mata uang: IDR selalu ada, dan CNY setelah Anda menerima pembayaran Alipay atau kartu. Nominal IDR dalam rupiah, nominal CNY dalam yuan (maksimal 2 desimal). PayOut hanya memakai saldo IDR. Periksa available sebelum membuat PayOut: nominal ditambah fee tidak boleh melebihinya.

FieldKeterangan
available Saldo yang sudah settle dan bisa dicairkan sekarang. Bisa minus setelah dispute atas dana yang sudah ditarik.
ready Nominal bersih PayIn yang sudah dibayar dan menunggu settlement; pindah ke available setelah settle
pending Selalu 0 (dipertahankan untuk kompatibilitas; tidak ada jeda settlement)
total available + ready
withdrawn Nominal + fee PayOut yang sudah disetujui (selesai, diproses, atau didispute)
pending_withdrawal Nominal + fee PayOut yang menunggu persetujuan. Belum dipotong, jadi perhitungkan terhadap available.
pending_settlement Nominal ready dikelompokkan per tanggal pembayaran (WIB) dan metode pembayaran

Response

200 OK
{
  "by_currency": [
    {
      "currency": "IDR",
      "available": 1250000,
      "pending": 0,
      "ready": 475000,
      "total": 1725000,
      "withdrawn": 3052500,
      "pending_withdrawal": 52500
    },
    {
      "currency": "CNY",
      "available": 1520.75,
      "pending": 0,
      "ready": 980.5,
      "total": 2501.25,
      "withdrawn": 0,
      "pending_withdrawal": 0
    }
  ],
  "pending_settlement": [
    {
      "date": "2026-11-09",
      "payment_method_code": "qris",
      "payment_method_name": "QRIS",
      "amount": 475000,
      "currency": "IDR"
    },
    {
      "date": "2026-11-09",
      "payment_method_code": "alipay",
      "payment_method_name": "Alipay",
      "amount": 980.5,
      "currency": "CNY"
    }
  ]
}

Webhook (callback)

Atur URL callback untuk menerima pembaruan status transaksi secara asinkron. Kami mengirim request POST berisi payload event.

amount dalam currency transaksi: rupiah untuk IDR, yuan untuk CNY (PayIn alipay dan card, misalnya 500 atau 500.5).

Satu URL callback menerima pembaruan PayIn dan payout. Bedakan dengan field direction: in untuk PayIn, out untuk payout yang dibuat lewat /transactions/transfer-out.

Payload callback (PayIn)

POST
{
  "event": "transaction.status_changed",
  "direction": "in",
  "transaction": {
    "invoice_number": "INV-2024-001",
    "amount": 100000,
    "currency": "IDR",
    "status": "completed",
    "reference": "ORD-1705312200000-ABC12345",
    "description": "Payment for INV-2024-001",
    "payment_method": { "code": "qris", "name": "QRIS", "type": "QRIS" },
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:05:00Z"
  },
  "timestamp": "2024-01-01T12:05:00Z"
}

Payload callback (PayOut)

POST
{
  "event": "transaction.status_changed",
  "direction": "out",
  "transaction": {
    "invoice_number": "INV-OUT-2024-001",
    "amount": 50000,
    "currency": "IDR",
    "status": "completed",
    "reference": "WD-12345678",
    "description": "Transfer out to merchant",
    "created_at": "2024-01-01T12:00:00Z",
    "updated_at": "2024-01-01T12:30:00Z"
  },
  "timestamp": "2024-01-01T12:30:00Z"
}

Event

  • transaction.status_changed — Dikirim saat status transaksi berubah (misalnya dari pending ke completed).

Status transaksi

  • completed — PayIn: pembayaran diterima. PayOut: transfer terkirim ke penerima.
  • failed — PayIn: pembayaran gagal atau dibatalkan provider. PayOut: transfer ditolak atau gagal di bank; nominal dan fee tidak dipotong, atau dikembalikan ke saldo. Sesekali PayOut bisa gagal setelah callback completed. PayOut yang gagal di bank juga bisa dikirim ulang oleh tim kami, dengan nominal dan fee dipotong lagi, lalu mengirim completed setelah failed. Selalu anggap callback terakhir sebagai final.
  • disputed — PayIn: pembayar menyanggah pembayaran yang sudah selesai. Nominal bersihnya ditahan dari saldo selama Anda mengunggah bukti pembayaran di dashboard (menu Dispute). PayOut: transfer yang sudah selesai sedang diperiksa, misalnya karena dikembalikan bank. Berakhir completed (transfer sah) atau failed (nominal dan fee dikembalikan ke saldo).
  • refunded — Khusus PayIn: dispute diputus tidak menguntungkan dan pembayaran dikembalikan ke pembayar. Nominal bersihnya tidak kembali ke saldo (fee tidak dikembalikan). Jika bukti diterima, Anda menerima completed lagi.
Catatan: Dalam kasus jarang, provider membatalkan pembayaran setelah berhasil. Anda akan menerima callback kedua untuk invoice_number yang sama dengan status failed setelah completed. Anggap status terakhir sebagai final: jangan abaikan callback untuk transaksi yang sudah Anda tandai lunas, dan batalkan pesanan di sisi Anda bila ini terjadi.

Keamanan & verifikasi

Setiap request webhook menyertakan header X-Signature: HMAC-SHA256 dari body request mentah, ditandatangani dengan Secret Key Anda, dalam format hex.

Penting:Selalu verifikasi signature dengan Secret Key Anda sebelum memercayai callback.
Referensi API | Anythink Pay