Integration Methods Summary

Cashlez Link Flow

Overview of Cashlez Link APIs

Host: https://api-link.cashlez.com/

All API requests must be made over HTTPS. Calls made over plain HTTP and API requests for Generate URL without authentication will fail.

No.	Endpoint	Usage
1.	/generate_url_vendor	Generate URL
2.	/validate_url	Check Transaction Status and Get Payment methods
3.	/process_url	Generate New Payment URL

Authentication

Verify the integrity of data exchanged between parties by creating a digital signature using RSA encryption.

More detail about authentication process you can visit Cashlez Link Authentication.

Schema 1

Schema 1 illustrates the sequence of steps that merchants follow when integrating with Cashlez using the default page. Merchant needs to call the Generate URL API and will get a payment URL that can be opened via a browser and let the customer make payments according to the desired method choice.

Schema 1 Sequence Diagram

Generate Url

Merchants use Generate Url API to request payment URLs from Cashlez, and once they receive a response from the API, they can open the URL in a web browser.

Setting	Value
Method	POST
Host	{HOST}
Path	/generate_url_vendor

More detail about Generate Url process you can visit Generate Url.

Payment Visualization

No.	Image	Description
1.		Payment URL opened in browser
2.		Card Payment selected as a payment method
3.		QRIS selected as a payment method
4.		Virtual Account selected as a payment method
5.		Success payment notification

Schema 2

Schema 2 illustrates how merchants integrate with Cashlez by using the additional payment method menu display. They achieve this by reviewing the response received from the Validate URL, which showcases the payment method initially set up by the merchant during their initial registration with Cashlez.

Shcema 2 Sequence Diagram

note

Generate URL need to hit before forwarding by hit Validate URL

Validate Url (Check Status)

Merchants use Validate Url API to request a check on all available payment methods and to verify transaction statuses by examining the response from the Generate URL.

Setting	Value
Method	POST
Host	{HOST}
Path	/validate_url

More detail about Validate Url you can visit Validate Url API.

Process Url

Merchants utilize Process Url API to update payment pages with customer-selected payment methods.

Setting	Value
Method	POST
Host	{HOST}
Path	/process_url

More detail about Process Url you can visit Process Url API.

Callback

Cashlez Callbacks are transaction notifications sent by Cashlez to merchants via APIs that have been registered in the Cashlez system. There are two types of callbacks, first is Callback Url where Cashlez will hit the APIs to the merchant as a transaction status notification, then there is a Callback Screen Url which will become the direct web page when the transaction has been completed.