Model Data - Saluran Pembayaran
Sekitar 2 menit
Ikhtisar Saluran Pembayaran
Model data Saluran Pembayaran mendefinisikan struktur untuk informasi metode dan pemrosesan pembayaran. Model ini mengkapsulasi spesifikasi metode pembayaran, detail pemrosesan, dan parameter khusus saluran.
Struktur Model Data
| Parameter | Tipe | Deskripsi |
|---|---|---|
| paymentMethod | String | Identifier metode pembayaran Format: Kode metode pembayaran yang telah ditentukan Contoh: BRI, UPI, QRPAY, PIX, SPEI Digunakan untuk mengidentifikasi saluran pembayaran spesifik untuk pemrosesan transaksi |
| vaNumber | String | Nomor Virtual Account atau Rekening Bank Format: String alfanumerik Penggunaan: Nomor VA Indonesia, rekening bank Thailand, akun SPEI Meksiko Diperlukan untuk metode pembayaran transfer bank |
| qrString | String | Data QR code atau URL gambar Format: String atau URL gambar HTTP Penggunaan: QRIS Indonesia, QRPAY Thailand, PIX Brasil Berisi data QR code untuk pemrosesan pembayaran mobile |
| paymentUrl | String | URL pemrosesan pembayaran utama Format: URL HTTP/HTTPS yang valid Penggunaan: Halaman checkout Smilepayz untuk penyelesaian pembayaran Diperlukan untuk semua metode pembayaran |
| receiverBankName | String | Nama bank penerima untuk transfer bank Format: String yang dienkripsi UTF-8 Penggunaan: Metode BANK Thailand, SPEI Meksiko Menentukan bank penerima untuk transaksi transfer |
| additionalInfo | Object | Informasi pemrosesan pembayaran tambahan Format: Object JSON Penggunaan: URL pembayaran yang diperluas, parameter pemrosesan Berisi data tambahan untuk metode pembayaran spesifik |
Contoh Implementasi Regional
Metode Pembayaran Indonesia
{
"additionalInfo": {
"paymentUrl": "https://link.dana.id/pay?bizNo=xxxxxxxxxL5dm6QkXs3kDg5HFBtgOtgHmPWpLD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
},
"paymentMethod": "W_DANA",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}
{
"additionalInfo": {},
"paymentMethod": "QRIS",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112410241325417215",
"qrString": "https://gateway.smilepayz.com/image/MER202110293394047135422905011630451D5.img"
}
{
"additionalInfo": {},
"paymentMethod": "QRIS",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112410241325417215",
"qrString": "0912121.2232323293.2323232.33xxxxxxxxxxxxxxxxxx3232wewess.w2323.QRIS.sdfdN.nubo.bsdfdc833434343"
}
{
"additionalInfo": {},
"paymentMethod": "BRI",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200112501021320331776",
"vaNumber": "1419001332911089"
}
Metode Pembayaran India
{
"additionalInfo": {
"paymentUrl": "upi://xxxxx612963233324SPOphhnctVDAIN5zq9s1z7cgoHpJkjnMXjGoMpMm0AD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
},
"paymentMethod": "UPI",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}
{
"additionalInfo": {
"paymentUrl": "https://xxxxx612963233324SPOphhnctVDAIN5zq9s1z7cgoHpJkjnMXjGoMpMm0AD9IU2qoxkqQhGJQfCYcn4tA8930VR%2BggxOHPDhZg%3D%3D&forceToH5=false"
},
"paymentMethod": "UPI",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=101200192501021315010115"
}
Metode Pembayaran Thailand
{
"additionalInfo": {},
"paymentMethod": "QRPAY",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=111200572411191251468673",
"qrString": "00020101021229370016A0000006770101110113006680870163353037645406299.985802TH63048436"
}
{
"additionalInfo": {},
"paymentMethod": "BANK",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1112001125042408363186433",
"receiverBankName": "KBANK",
"vaNumber": "2053617290"
}
Metode Pembayaran Brasil
{
"additionalInfo": {},
"paymentMethod": "PIX",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=131200112412130836186234",
"qrString": "00020101021226800014br.gov.bcb.pix2558pix.delbank.com.br/v2/cob/vcharge1f6aed0623644c24bbdc174ce5204000053039865802BR5907DELBANK6007ARACAJU62070503***6304BC39"
}
Metode Pembayaran Meksiko
{
"additionalInfo": {},
"paymentMethod": "SPEI",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1412075825061113364201615",
"receiverBankName": "STP",
"vaNumber": "6461805637046123212"
}
Metode Pembayaran Peru
{
"additionalInfo": {
"paymentUrl": "https://checkout.pe.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=PER&ChannelID=ONLINE"
},
"paymentMethod": "CASHIER_PE",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}
Metode Pembayaran Kolombia
{
"additionalInfo": {
"paymentUrl": "https://checkout.co.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=COL&ChannelID=ONLINE"
},
"paymentMethod": "CASHIER_CO",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}
Metode Pembayaran Chili
{
"additionalInfo": {
"paymentUrl": "https://checkout.cl.1pago.net/checkout/checkout-s.html?TokenID=e064c70d-3f1b-48f1-a628-2448f51bc54f&CountryID=CHL&ChannelID=ONLINE"
},
"paymentMethod": "CASHIER_CL",
"paymentUrl": "https://gateway.smilepayz.com/cashier/#/loading?tradeNo=1512024025061111131298291"
}
Panduan Implementasi
Pemilihan Metode Pembayaran
- Dompet Digital: Gunakan metode pembayaran khusus e-wallet dengan URL pembayaran tambahan
- Pembayaran QR: Sertakan data QR string untuk pemrosesan pembayaran mobile
- Transfer Bank: Berikan nomor virtual account dan informasi bank penerima
- Pembayaran Tunai: Gunakan metode pembayaran kasir dengan URL checkout eksternal
Pertimbangan Keamanan
- Validasi URL: Pastikan semua URL pembayaran menggunakan protokol HTTPS
- Enkripsi Data: Data pembayaran sensitif harus dienkripsi dalam transit
- Manajemen Token: Penanganan yang aman untuk token pembayaran dan data sesi
- Audit Logging: Pertahankan log komprehensif untuk aktivitas pemrosesan pembayaran