Payment Integration API (Revamp)

Endpoint URL

The endpoint URL is a feedback URL that will process the data in the post from the merchant system. For the implementation of the testing, UAT can use URL development.

Request Parameter

Request parameters are parameters that the merchant's system must provide that can be integrated with the system Faspay.

Parameter
Type
M/O/C
Description

transaction_type

Integer(2)

M

For credit payment, always use value ‘1’.

response_type

Integer(1)

O

For credit card payment, always use value '2'.

merchant_id

Varchar(30)

M

Your Faspay Merchant ID.

payment_method

Integer(1)

O

For. credit card payment always use value '1'.

merchant_tranid

Varchar(100)

M

Merchant’s unique transaction id.

currencycode

Varchar(3)

M

Indicate the currency of this transaction. Currently only support IDR.

amount

Varchar(10)

M

Amount of transaction. Supports up to 2 decimal points. E.g. amount is IDR 10000, set value as 10000.00.

custname

Varchar(120)

M

Shopper’s name.

custemail

Varchar(100)

M

Shopper’s email address.

description

Varchar(100)

M

Short description of the order.

return_url

Varchar(100)

O

URL that page will be redirected with the transaction response after transaction has been processed. Merchant should translate the response parameter pass back to this URL and display user-friendly message to cardholder.

billing_address

Varchar(200)

M

Shopper’s billing address.

billing_address _city

Varchar(50)

O

Shopper’s billing city.

billing_address _region

Varchar(100)

O

Shopper’s billing region.

billing_address _state

Varchar(100)

O

Shopper’s billing state.

billing_address _poscode

Varchar(10)

O

Shopper’s billing postcode.

billing_address _country_code

Varchar(10)

O

Shopper’s billing country code.

phone_no

Varchar(20)

O

Shopper's phone number.

style_image_url

Varchar(100)

O

Image URL for merchant’s logo.

callback_url

Alphanumeric(100)

O

Callback URL that will be hit after payment occur. Response of payment will be sent through this URL.

signature

Varchar(40)

M

Transaction signature of request for data integrity check.

Response Parameter

Response parameters are parameters that will be delivered by the system Faspay in response to the request parameters that have been sent by the merchant system. If no parameters are appropriate / value is incorrect, the transaction will be rejected in the system Faspay.

Parameter
Data Type
M/O/C
Description

response_code

String(7)

M

Response code.

response_message

String(150)

M

Response description.

url

Alphanumeric(100)

O

Redirect URL to continue payment through Faspay.

Last updated