Hosted Payment

Introduction

Hosted Payment is one of the recomended products that allows Merchants to easily and quickly integrate with Finpay Payment Gateway to start accepting payments with any of payment method options. Hosted Payment uses a Web Page URL redirect mechanism with single integration process, Hosted Payment allow to choose various payment methods in Finpay Page. This mechanism is suitable for every business scale from small businesses to enterprises.

This is an overview of how Hosted Payment works :

Preview Hosted Payment UI

Transaction Flow

The overall end-to-end payment process in Hosted Payment is illustrated in following sequence diagram:

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": "[email protected]",
    "firstName": "Hajar",
    "lastName": "Ismail",
    "mobilePhone": "[phone]"
  },
  "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
}