Checkout Finance

Decentro's Checkout Finance stack aims at enabling embedded finance to our customers with a single API. All additional tasks such as performing KYC of the customer, liveliness checks, agreement generation and e-signing, displaying all the loan facilities available to the end user and confirming a facility via an OTP is done in a customisable UI that is managed by Decentro.

Loan Application API

This single API lets companies complete an eligibility test against an applicant and complete the entire loan disbursement process via a redirection to a fully managed lending UI.

The API does a preliminary check of eligibility. If the customer is eligible for a loan, the API returns a pre-approved amount and a URL where the user is redirected. This is where Decentro manages complex KYC flows of multiple lenders seamlessly and completes the KYC of the user.

The client does not have to worry about creating the customer profile, completing KYC and then showing loan tenures to the customer. All these complexities are handled by Decentro.

If the amount is not provided, then the lending UI terminates after completing KYC eligibility. However, if the amount is provided, the UI goes further into agreement signing and confirmation of the loan facility as well. Clients can use this API by providing the value of the cart as the required amount in the request body.

{
    "reference_id": "DEC0001",
    "consent": true,
    "purpose": "For BNPL on the cart page",
    "mobile": "XXXXXXXXXXXX",
    "pan": "ABCDE1234F",
    "name": "John Doe",
    "requested_amount": 9999.0,
    "redirection_url": "http://myshop.com/cart"
}

{
    "decentroTxnId": "XXXX",
    "status": "SUCCESS",
    "responseCode": "S00000",
    "data": {
        "transactionStatus": "SUCCESS",
        "transactionDescription": "Pre-approval check successful. Consumer is eligible for credit line.",
        "urn": "XXXX",
        "sessionLink": "https://staging.checkout.decentro.tech",
        "stage": "SESSION_INITIATED",
        "amount": 10000
    },
    "responseKey": "success_eligibility_check"
}

Get Loan Status API

This API helps you keep track of the loan session that happens on the loan application UI. The API accepts the transaction URN received in the response of the Loan Application API.

The loan application stage progresses through the following steps:

During all steps of the loan application, the Get Status API will provide a response that looks like the following:

{
    "decentroTxnId": "XXXX",
    "status": "SUCCESS",
    "responseCode": "S00000",
    "data": {
        "eligibilityCheckReferenceId": "XXXX",
        "eligibilityCheckTransactionUrn": "XXXX",
        "consumer": {
            "name": "Han Solo",
            "mobile": "9999999999",
            "kycStatus": "PENDING"
        },
        "stage": "SESSION_INITIATED",
        "status": "PENDING",
        "creationTimestamp": "YYYY-MM-DD HH:MM:SS"
    },
    "responseKey": "success_session_details_fetched"
}

During the last step of the loan application, the Get Status API will provide a response that also contains the facility that the user has confirmed a facility:

{
    "decentroTxnId": "XXXX",
    "status": "SUCCESS",
    "responseCode": "S00000",
    "data": {
        "eligibilityCheckReferenceId": "XXXX",
        "eligibilityCheckTransactionUrn": "XXXX",
        "consumer": {
            "name": "Han Solo",
            "mobile": "9999999999",
            "kycStatus": "SUCCESS"
        },
        "facility": {
            "urn": "XXXX",
            "amount": 4565.0,
            "emiCount": 1
        },
        "stage": "FACILITY_CONFIRMED",
        "status": "SUCCESS",
        "creationTimestamp": "YYYY-MM-DD HH:MM:SS",
        "lastModificationTimestamp": "YYYY-MM-DD HH:MM:SS"
    },
    "responseKey": "success_session_details_fetched"
}