Pay-in (penerimaan) · Vietnam

API pay-in wilayah Vietnam (VND). Lihat metode pembayaran.

Permintaan

POST/v2.0/transaction/pay-in

Path permintaan:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/transaction/pay-in
production: https://gateway.smilepayz.com/v2.0/transaction/pay-in

Parameter header

Field	Wajib	Tipe	Deskripsi
Content-Type	M	String	Isi permintaan application/json.
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm (mis. Vietnam ICT +07:00).
X-SIGNATURE	M	String	Tanda tangan isi JSON (lihat dokumen Signature).
X-PARTNER-ID	M	String	Your merchantID

Parameter body

Field	Wajib	Tipe	Deskripsi
orderNo	M	String(32)	ID unik merchant, 6–32 alfanumerik.
purpose	M	String(64)	Catatan untuk pembayar, 1–64 karakter UTF-8.
merchant	M	Object	Membungkus merchantId dan field sub-merchant opsional.
merchantId	M	String	merchantId Smilepayz untuk panggilan ini.
merchantName	O	String	Nama tampilan merchant UTF-8.
subMerchantId	O	String	ID sub-merchant.
subMerchantName	O	String	Nama UTF-8 untuk subMerchantId.
money	M	Object	Mata uang dan jumlah untuk transaksi ini.
currency	M	String	Tetap VND.
amount	M	Number	Amount
paymentMethod	O	String	Kode (lihat dokumen metode pembayaran).
expiryPeriod	O	Number	ExpiryPeriod, default 3600.
redirectUrl	O	String(256)	URL HTTPS kembali setelah bayar, maks 256 karakter.
callbackUrl	O	String(256)	URL HTTPS notifikasi status async, maks 256 karakter.

---

Contoh body – permintaan transaksi:

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

{
    "orderNo": "20011563d9094aa7d4d9e9b933bb",
    "purpose": "E-wallet top-up — HCMC",
    "merchant": {
        "merchantId": "20011"
    },
    "money": {
        "currency": "VND",
        "amount": 1000000
    },
    "paymentMethod": "W_MOMO",
    "redirectUrl": "https://www.example.com/success"
}

Respons

HTTP (permintaan)

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

Parameter body

Field	Wajib	Tipe	Deskripsi
code	M	String	00 sukses, nilai lain error.
message	M	String	Baris hasil terbaca manusia UTF-8.
orderNo	M	String	ID unik merchant, 6–32 alfanumerik.
tradeNo	O	String	tradeNo Smilepayz untuk pesanan ini.
merchant	M	Object	Membungkus merchantId dan field sub-merchant opsional.
merchantId	M	String	merchantId Smilepayz untuk panggilan ini.
merchantName	O	String	Nama tampilan merchant UTF-8.
subMerchantId	O	String	ID sub-merchant.
subMerchantName	O	String	Nama UTF-8 untuk subMerchantId.
money	M	Object	Mata uang dan jumlah untuk transaksi ini.
currency	M	String	Tetap VND.
amount	M	Number	Amount
transactionTime	M	String	yyyy-MM-ddTHH:mm:ss±HH:mm
channel	M	Object	Muatan saluran (paymentUrl, qrString, …).
paymentMethod	O	String	Kode (lihat metode pembayaran).
paymentUrl	M	String	URL kasir untuk dibuka pembayar.
status	O	String	Nilai enum status pesanan atau status pembayaran.

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

{
    "code": "00",
    "message": "Successful",
    "orderNo": "20011563d9094aa7d4d9e9b933bb",
    "tradeNo": "1812001125042115424463245",
    "merchant": {
        "merchantId": "20011",
        "merchantName": "Smilepayz Demo Store",
        "accountNo": "11820011202403071031"
    },
    "money": {
        "currency": "VND",
        "amount": 1000000
    },
    "transactionTime": "2025-06-19T10:31:33+07:00",
    "channel": {
        "paymentMethod": "W_MOMO",
        "paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1812001125042115424463245"
    },
    "status": "PROCESSING"
}

Notifikasi / callback

HTTP (permintaan)

Field	Wajib	Tipe	Deskripsi
Content-Type	M	String	Isi application/json.
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	Tanda tangan body callback (lihat panduan tanda tangan callback).

Parameter body

Field	Wajib	Tipe	Deskripsi
orderNo	M	String	ID unik merchant, 6–32 alfanumerik.
tradeNo	M	String	tradeNo Smilepayz untuk pesanan ini.
merchantId	M	String	merchantId Smilepayz untuk panggilan ini.
merchantName	M	String	Nama tampilan merchant UTF-8.
subMerchantId	O	String	ID sub-merchant.
subMerchantName	O	String	Nama UTF-8 untuk subMerchantId.
paymentMethod	M	String	Kode (lihat metode pembayaran).
transactionTime	M	String	Format: yyyy-MM-ddTHH:mm:ss
status	M	String	Nilai enum status pesanan atau status pembayaran.
money	M	Object	Mata uang dan jumlah untuk transaksi ini.
currency	M	String	Tetap VND.
amount	M	Number	Amount

Respons

Penting

Hanya membalas dengan string SUCCESS.

{
    "orderNo": "20011563d9094aa7d4d9e9b933bb",
    "tradeNo": "1812001125042115424463245",
    "merchantId": "20011",
    "merchantName": "Smilepayz Demo Store",
    "subMerchantId": "",
    "subMerchantName": "",
    "paymentMethod": "W_MOMO",
    "transactionTime": "2025-06-19T10:31:33+07:00",
    "status": "SUCCESS",
    "money": {
        "currency": "VND",
        "amount": 1000000
    }
}

SUCCESS