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.
https://www.snacknfrozen.com/api/liveSemua path endpoint di bawah relatif terhadap base URL ini, misalnya Buat PayIn adalah POST https://www.snacknfrozen.com/api/live/transactions.
X-Access-Key: <your_access_key>
X-Secret-Key: <your_secret_key>Buat PayIn
https://www.snacknfrozen.com/api/live/transactionsMembuat 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.
| Metode | payment_method_code | Mata uang | Yang ditampilkan ke pelanggan |
|---|---|---|---|
| QRIS | qris | IDR | QR dari qr_content |
| Virtual Account | bca_va, mandiri_va, … | IDR | va_number |
| Alipay | alipay | CNY | payment_url atau gambar QR |
| Kartu Bank China | card | CNY | payment_url atau rekening bank |
Field umum
| Field | Keterangan |
|---|---|
| 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.
PayIn: QRIS
https://www.snacknfrozen.com/api/live/transactionspayment_method_code qris · IDRMengembalikan 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.
| Field | Keterangan |
|---|---|
| amount * | Dalam rupiah. Akun yang dilayani provider SATRUN minimal 10000; nominal di bawahnya mendapat 400. |
| currency | IDR |
{
"payment_method_code": "qris",
"invoice_number": "INV-2024-001",
"amount": 100000,
"currency": "IDR",
"description": "Payment for order #123"
}{
"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.
PayIn: Virtual Account
https://www.snacknfrozen.com/api/live/transactionspayment_method_code <bank>_va · IDRMengembalikan nomor virtual account di va_number yang ditransfer pelanggan dari banknya. Pakai kode bank, misalnya bca_va, mandiri_va, bri_va, atau bni_va.
| Field | Keterangan |
|---|---|
| payment_method_code * | misalnya mandiri_va (va_mandiri juga diterima) |
| amount * | Dalam rupiah |
{
"payment_method_code": "mandiri_va",
"invoice_number": "INV-2024-002",
"amount": 50000,
"currency": "IDR",
"description": "Payment for order #456"
}{
"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"
}
}PayIn: Alipay
https://www.snacknfrozen.com/api/live/transactionspayment_method_code alipay · CNYUntuk 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.
| Field | Keterangan |
|---|---|
| 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 |
{
"payment_method_code": "alipay",
"invoice_number": "INV-CN-001",
"amount": 500,
"currency": "CNY",
"customer_name": "Li Wei",
"description": "Order #789"
}{
"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.
PayIn: Kartu Bank China
https://www.snacknfrozen.com/api/live/transactionspayment_method_code card · CNYUntuk 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.
| Field | Keterangan |
|---|---|
| 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 |
{
"payment_method_code": "card",
"invoice_number": "INV-CN-002",
"amount": 1000,
"currency": "CNY",
"customer_name": "Wang Fang",
"description": "Order #790"
}{
"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"
}
}Buat PayOut
https://www.snacknfrozen.com/api/live/transactions/transfer-outMengirim 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
{
"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"
}
}| Field | Keterangan |
|---|---|
| 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
{
"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"
}
}{
"error": "Minimum payout amount is 10000"
}Daftar Bank
https://www.snacknfrozen.com/api/live/banksBank 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.
{
"banks": [
{ "bank_code": "014", "bank_id": 6, "bank_name": "BCA", "type": "bank" },
{ "bank_code": null, "bank_id": 165, "bank_name": "DANA", "type": "ewallet" }
]
}Cek Status Transaksi
https://www.snacknfrozen.com/api/live/transactions/:id/check-statusMengembalikan 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
| Status | Keterangan |
|---|---|
| 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
{
"success": true,
"is_paid": true,
"updated": false,
"status": "succeeded",
"reference": "ORD-1705312200000-ABC12345",
"invoice_number": "INV-2024-001",
"direction": "in",
"message": "Transaction has succeeded."
}{
"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"
}{
"error": "Transaction not found"
}Cek Saldo
https://www.snacknfrozen.com/api/live/balanceMengembalikan 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.
| Field | Keterangan |
|---|---|
| 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
{
"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)
{
"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)
{
"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 callbackcompleted. PayOut yang gagal di bank juga bisa dikirim ulang oleh tim kami, dengan nominal dan fee dipotong lagi, lalu mengirimcompletedsetelahfailed. 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. Berakhircompleted(transfer sah) ataufailed(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 menerimacompletedlagi.
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.