For the previous version of this API Reference, please refer to the legacy documentation here.
hub.finpay
Ctrlk
DocumentationAPI ReferenceDashboardFinpay Website
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Two Click Payment

Two-click payment is a payment model concept that refers to a simplified checkout process for online purchases. The idea behind two-click payment is to reduce the number of steps required for customers to complete a transaction, making the process fast and convenient. Since the customer's credit card data information is already stored, they only need to fill in the Card Security Code to process the transaction.

INFO

Before doing this process, make sure you have done the Retrieve Stored Card API to get the credit card token used for the transaction.

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

Data 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

M

1

7

Detail of Card

8

recurring

Object

O

1

11

Detail of Recurring

9

sourceOfFunds

Object

M

1

11

Detail of SourceOfFunds

10

device

Object

O

1

7

Detail of Device

Sample Request

{
  "customer": {
    "id": "hajar.finnet@gmail.com",
    "email": "hajar.finnet@gmail.com",
    "firstName": "Hajar",
    "lastName": "Ismail",
    "mobilePhone": "+6281286288844"
  },
  "order": {
    "id": "1685522371836",
    "amount": "1000",
    "currency": "IDR",
    "description": "Testing"
  },
  "url": {
    "callbackUrl": "https://sandbox.finpay.co.id/simdev/finpay/result/tangkapCurl.php"
  },
  "card": {
    "token": "81b36a850c2e40458bad296f952084b516c919ca717d448722782769b81b9fd9",
    "storedOnFile": "STORED"
  },
  "sourceOfFunds": {
    "type": "cc"
  }
}

Data 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

Last updated