Hosted Payment
Introduction
Finpay IPG Hosted merupakan salah satu produk unggulan yang memungkinkan Merchant melakukan integrasi secara mudah dan cepat dengan Finpay Payment Gateway untuk mulai menerima pembayaran melalui berbagai pilihan metode bayar. IPG Hosted menggunakan mekanisme pengalihan URL Halaman Web, pemilihan metode bayar akan terjadi pada halaman Finpay sehingga merchant hanya perlu melakukan proses integrasi sekali saja. IPG Hosted seuai untuk semua skala bisnis baik itu kecil sampai ke industri besar.
This is an overview of how Hosted Payment works :
Transaction Flow
Keseluruhan proses pembayaran end-to-end di Hosted Payment digambarkan dalam sequence diagram berikut:
API Request
| Environment | Method | URL |
|---|---|---|
| Development | POST | https://devo.finnet.co.id/pg/payment/card/initiate |
| Production | POST | https://live.finnet.co.id/pg/payment/card/initiate |
Body Request
| No | Name | Type | Mandatory | Min Length | Max Length | Description |
|---|---|---|---|---|---|---|
| 1 | order | Object | M | 1 | 12 | Detail of Order |
| 2 | customer | Object | M | 1 | 8 | Detail of Customer |
| 3 | url | Object | M | 1 | 4 | Detail of Url |
| 4 | billing | Object | O | 1 | 1 | Detail of Billing |
| 5 | shipping | Object | O | 1 | 4 | Detail of Shipping |
| 6 | meta | Object | O | 1 | 1 | Detail of MetaData |
| 7 | card | Object | O | 1 | 7 | Detail of Card |
| 8 | recurring | Object | O | 1 | 11 | Detail of Recurring |
| 9 | sourceOfFunds | Object | O | 1 | 11 | Detail of SourceOfFunds |
| 10 | device | Object | O | 1 | 7 | Detail of Device |
Sample Request
{
"customer": {
"email": "hajar.finnet@gmail.com",
"firstName": "Hajar",
"lastName": "Ismail",
"mobilePhone": "+6281286288844"
},
"order": {
"id": "order123",
"amount": "1000",
"description": "Testing"
},
"url": {
"callbackUrl": "https://sandbox.finpay.co.id/simdev/finpay/result/resultsuccess.php"
}
}
Body Response
| No | Name | Type | Mandatory | Min Length | Max Length | Description |
|---|---|---|---|---|---|---|
| 1 | responseCode | Enum | M | 1 | 7 | Response Code |
| 2 | responseMessage | String | M | 1 | 500 | Response Message |
| 3 | paymentCode | String | O | 1 | 30 | Payment Code |
| 4 | redirecturl | String | M | 1 | 320 | Redirect URL |
| 5 | expiryLink | String | M | 1 | 19 | Expiry Link |
| 6 | processingTime | Number | M | 1 | 20 | Processing Time |
| 7 | appurl | String | O | 1 | 320 | App URL |
| 8 | imageurl | String | O | 1 | 320 | Image URL |
| 9 | accountList | Array | O | 1 | 4 | Account List |
Sample Response
{
"responseCode": "2000000",
"responseMessage": "Success",
"redirecturl": "https://devo.finpay.id/pg/payment/card/v2/access/ebb8367ac6a3efcb2498766234a528536df37e01db10831523dc03c67234ef82",
"expiryLink": "2023-05-18 14:55:24",
"processingTime": 0.5706689357757568
}