Pencairan (Pay-out · Mesir)

API pay-out wilayah Mesir (EGP). Lihat Metode pembayaran.

Permintaan

POST/v2.0/disbursement/pay-out

URL permintaan:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/disbursement/pay-out
production: https://gateway.smilepayz.com/v2.0/disbursement/pay-out

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 (contoh EET +02:00).
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
orderNo	M	String(32)	Nomor order unik dari merchant, 6–32 karakter alfanumerik.
purpose	M	String(64)	Ringkasan transaksi, 1–64 karakter UTF-8.
merchant	M	Object	Berisi merchantId dan field sub-merchant opsional.
merchantId	M	String	merchantId Smilepayz untuk permintaan ini.
merchantName	O	String	Nama tampilan merchant UTF-8, opsional.
subMerchantId	O	String	ID sub-merchant, opsional.
subMerchantName	O	String	Nama UTF-8 untuk subMerchantId, opsional.
money	M	Object	Objek nominal berisi currency dan amount transaksi.
currency	M	String	Kode mata uang untuk permintaan ini.
amount	M	Number	Amount (maks. 2 desimal). Lihat Money
paymentMethod	M	String	Kode bank Mesir; lihat Metode pembayaran.
cashAccount	M	String(64)	Nomor rekening bank penerima.
receiver	O	Object	Data penerima. Jika tidak dikirim, Smilepayz mengisi informasi pihak yang dibutuhkan channel.
name	O	String	Nama lengkap penerima (UTF-8).
email	O	String	Email penerima.
phone	O	String	Nomor telepon penerima.
callbackUrl	O	String(256)	URL HTTPS untuk notifikasi status async, maksimal 256 karakter.

---

Contoh body – permintaan pay-out:

Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+02:00
X-SIGNATURE: 7MHd9v5/m9JeqmDZVwWBZUZ5J5...7120QnFEny7Qm7uQR1G0TWCh10fsU6nVxiRoeoQ==
X-PARTNER-ID: 20001

{
    "orderNo": "2000102900000000000001",
    "purpose": "Pembayaran kontraktor Cairo",
    "merchant": {
        "merchantId": "20001"
    },
    "money": {
        "currency": "EGP",
        "amount": 20000
    },
    "paymentMethod": "NBE",
    "cashAccount": "0012345678",
    "receiver": {
        "name": "Ahmed Hassan El-Masry",
        "email": "[email protected]",
        "phone": "201234567890"
    }
}

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.
orderNo	M	String	Nomor order unik dari merchant, 6–32 karakter alfanumerik.
tradeNo	O	String	tradeNo Smilepayz untuk order ini.
status	O	String	Nilai enum status order atau pembayaran.
disbursementTime	M	String	Format waktu: yyyy-MM-ddTHH:mm:ss±HH:mm.
merchant	M	Object	Berisi merchantId dan field sub-merchant opsional.
merchantId	M	String	merchantId Smilepayz untuk permintaan ini.
merchantName	O	String	Nama tampilan merchant UTF-8, opsional.
subMerchantId	O	String	ID sub-merchant, opsional.
subMerchantName	O	String	Nama UTF-8 untuk subMerchantId, opsional.
accountNo	O	String	accountNo settlement jika dikembalikan gateway.
money	M	Object	Objek nominal berisi currency dan amount transaksi.
currency	M	String	Kode mata uang untuk permintaan ini.
amount	M	Number	Amount (maks. 2 desimal). Lihat Money
channel	M	Object	Data channel, seperti paymentUrl, qrString, dan lainnya.
paymentMethod	M	String	Kode metode pembayaran (lihat dokumen Metode pembayaran).
cashAccount	M	String	Nomor rekening bank penerima.
accountName	O	String	Nama tampilan penerima saat dikembalikan channel.

Contoh body – respons pay-out:

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

{
    "code": "00",
    "message": "Successful",
    "orderNo": "2000102900000000000001",
    "tradeNo": "1522000109e998347483949",
    "status": "PROCESSING",
    "disbursementTime": "2024-12-17T10:55:00+02:00",
    "merchant": {
        "merchantId": "20001",
        "merchantName": "Smilepayz Demo Store",
        "accountNo": "2000124234782342"
    },
    "money": {
        "currency": "EGP",
        "amount": 20000
    },
    "channel": {
        "paymentMethod": "NBE",
        "cashAccount": "0012345678",
        "accountName": "Ahmed Hassan El-Masry"
    }
}

Notifikasi/Callback

Callback signature ≠ request signature

Jangan verifikasi X-SIGNATURE callback dengan formula request. Lihat Callback Signature.

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
X-SIGNATURE	M	String	Lihat Callback Signature

Parameter body

Field	Wajib	Tipe	Deskripsi
orderNo	M	String	Nomor order unik dari merchant, 6–32 karakter alfanumerik.
tradeNo	M	String	tradeNo Smilepayz untuk order ini.
merchantId	M	String	merchantId Smilepayz untuk permintaan ini.
merchantName	M	String	Nama tampilan merchant UTF-8, opsional.
subMerchantId	O	String	ID sub-merchant, opsional.
subMerchantName	O	String	Nama UTF-8 untuk subMerchantId, opsional.
paymentMethod	M	String	Kode metode pembayaran (lihat dokumen Metode pembayaran).
transactionTime	M	String	Waktu penyelesaian.
money	M	Object	Objek nominal berisi currency dan amount transaksi.
currency	M	String	Kode mata uang untuk permintaan ini.
amount	M	Number	Amount (maks. 2 desimal). Lihat Money
status	M	String	Nilai enum status order atau pembayaran.

Respons callback

Penting

Balas hanya dengan string SUCCESS.

{
    "orderNo": "2000102900000000000001",
    "tradeNo": "1522000109e998347483949",
    "merchantId": "20001",
    "merchantName": "Smilepayz Demo Store",
    "subMerchantId": "",
    "subMerchantName": "",
    "paymentMethod": "NBE",
    "transactionTime": "2024-12-17T10:55:00+02:00",
    "money": {
        "currency": "EGP",
        "amount": 20000
    },
    "status": "SUCCESS"
}

SUCCESS