FinGate
Craftgate has an integration with FinGate which is one of shopping loan integrator. You can inquire shopping loan bank payment table, make an shopping loan application and make payment with shopping loan via using Craftgate API.
Things to do first
In order to use the FinGate integration, you must have completed the following steps.
Alternative Payment Method Integration must be
Onon Merchant Panel > Administration > Merchant Settings > Craftgate Features list.
Enter the information sent to you by FinGate on Merchant Panel > Administration > APM Management > FinGate after
EnableFinGate Integration status.
Bank Payment Plan Inquire
When making payments using shopping loan through Craftgate, the banks and the payment plan of these banks can be inquired by providing certain product-related information.
The payment plan inquiry may vary on a bank-by-bank basis, and some banks may not provide payment plan details.
Due to the restrictions imposed by the BDDK, when making an inquiry, quantity, amount, and category information related to the product should be provided. You can review the category codes defined by Craftgate: See: Category Codes
See: Bank Payment Table Inquire
Pay via FinGate Shopping Loan
After the payment plan is inquired, the bank will be selected and the payment flow begins. The loan application process is initiated by triggering the shopping loan payment flow via Craftgate. The customer should be directed to the bank's link that is received in response and the loan application process can continue at the bank side. Payment flows may differ depending on the bank.
In banks with an automatically approved loan application processes (such as İşbank, Akbank, TEB), when a loan application is approved by the bank, it will redirect to Craftgate system.
Craftgate will redirect the payment page to callbackUrl which is sent in initialize request, and thus finalizes the payment process with shopping loan.
For banks without automatic approval (such as Fibabank, Denizbank), the process may vary according to customer agreements. However, when the bank approves the loan on their side, it transitions to the 'Credit ready for use' status, and the merchant is expected to make one final shopping loan approval service call to disburse the credit.
At the merchant's end, the flow should be designed based on the additionalAction parameter provided by Craftgate which will be sent to callbackUrl.
AdditionalAction values are as follows:
| Value | Description |
|---|---|
NONE | It is used in the automatic approved shopping loan application process. The loan has been disbursed to the customer and the merchant has received the payment. |
APPROVAL_REQUIRED | It is used when the shopping loan is ready for use. Without automatic approval process. bank wait for loan approval request. Merchant will check their system and calls loan approval service to complete the process. |
WAIT_FOR_WEBHOOK | It is used for banks that do not work with automatic approval and are in the ongoing application process. The credit application is in the evaluation process. When the process is completed, information will be sent to the Craftgate system. Craftgate will notify the merchant through a Webhook Notification. By checking the additionalAction value in the Webhook message, credit can be disbursed by making a credit approval service call. |
You can use the channel parameter in additionalParams to specify the channel through which the shopping credit will be used. This value can be WEB and MOBILE.
"additionalParams": {
"channel": "WEB"
}
Approving Shopping Loan
After the loan application process, the merchant should call the loan approval service on the Craftgate side when the additionalAction parameter is received as APPROVAL_REQUIRED at the callbackUrl address
or - depending on the banks and agreements - at the webhook address when WAIT_FOR_WEBHOOK occurs. The merchant is required to perform their own checks and call the loan approval service on the Craftgate side to approve the loan.