Inquiry saldo (Mesir)

API inquiry saldo wilayah Mesir (EGP).

Permintaan

POST/v2.0/inquiry-balance

URL permintaan:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/inquiry-balance
production: https://gateway.smilepayz.com/v2.0/inquiry-balance

Parameter header

Field	Wajib	Tipe	Deskripsi
Content-Type	M	String	Body JSON application/json.
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	Tanda tangan body JSON (lihat dokumen produk Tanda tangan).
X-PARTNER-ID	M	String	merchantID Anda (alfanumerik).

Parameter body

Field	Wajib	Tipe	Deskripsi
accountNo	M	String(128)	Nomor rekening settlement merchant untuk mata uang ini (Pay-in atau Pay-out).
balanceTypes	M	List(String)	Contoh ["BALANCE"]; tipe saldo yang diminta.

accountNo

• Sandbox: string non-kosong (≤128). Boleh pakai nilai contoh di body di bawah.
• Production: Merchant Portal → Finance → Balance. Tiap mata uang punya Pay-in / Pay-out terpisah — kirim yang ingin di-inquiry. Lihat How to get production accountNo.

---

Contoh body – permintaan inquiry saldo:

Content-type: application/json
X-TIMESTAMP: 2020-12-18T15:06:00+02:00
X-SIGNATURE: 85be817c55b2c135157c7e89f52499bf0c25ad6eeebe04a986e8c862561b19a5
X-PARTNER-ID: 20001

{
    "accountNo": "21220030202403071031",
    "balanceTypes": [
        "BALANCE"
    ]
}

Respons

Header HTTP

Field	Wajib	Tipe	Deskripsi
Content-Type	M	String	Body JSON application/json.
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm

Parameter body

Field	Wajib	Tipe	Deskripsi
code	M	String	00 berarti berhasil; nilai lain berarti gagal.
message	M	String	Pesan hasil UTF-8 yang dapat dibaca.
accountInfos	M	Object	Berisi balanceType, amount, dan availableBalance.
balanceType	M	String	Contoh BALANCE.
amount	M	Object	Objek Money (currency + amount). Desimal: Money
currency	M	String	Kode mata uang untuk permintaan ini.
value	M	String	Nilai saldo dalam format string.
availableBalance	M	Object	Saldo tersedia, dengan struktur yang sama seperti amount.
currency	M	String	Kode mata uang untuk permintaan ini.
value	M	String	Saldo tersedia dalam format string.
accountNo	M	String	Echo dari accountNo pada request.
name	O	String	Nama tampilan akun jika dikembalikan.
balanceTypes	O	Array	Mengembalikan tipe saldo yang diminta.

Contoh body – respons inquiry saldo:

Content-type: application/json 
X-TIMESTAMP: 2020-12-17T10:55:00+02:00

{
    "code": "00",
    "message": "Successful",
    "accountInfos": {
        "balanceType": "BALANCE",
        "amount": {
            "currency": "EGP",
            "value": "250000"
        },
        "availableBalance": {
            "currency": "EGP",
            "value": "250000"
        }
    },
    "accountNo": "21220030202403071031",
    "name": "Sandbox Test",
    "balanceTypes": [
        "BALANCE"
    ]
}