Intro

📘
Set up your webhook
Before you can read and understand this page, you need to create your webhook in the rekon tool. We recommend visiting our knowledge center to learn how to register webhooks. You can find more information about rekon webhooks here.

Remember that every time you create a webhook in rekon, kiban will automatically generate an API key. This API key will be included in all of our notifications. Its purpose is for you to validate the notifications and verify that they are from rekon.

Types of notifications

Currently, rekon provides the following notifications:

Notification of a payment: You will receive this notification via webhook whenever we detect that one of your clients has made a payment to your account.

🚧
Soon more notifications
We are actively working on providing you with more notifications. Please stay tuned to this documentation and our newsletters to learn more about kiban services.

Notification of a payment

Below, you will find an example of the JSON that we will send you each time a payment is received from your clients to your account and the description for each field.

{
    "created":"2023-09-29T05:00:02+00:00",
    "eventType":"PAYMENT",
    "payment": {
        "id": "6516e779be74bcbac3394811",
        "paymentMethodType": "speiByKiban",
        "speiByKibanDetail": {
            "operationDate": "2023-09-29",
            "senderInstitution": "40012",
            "senderAccount": "123456789123456789",
            "senderRfc": "KIB911001CH3",
            "trackingKey": "MBAN01002309290071326765",
            "amount": 1,
            "beneficiaryAccount": "646180262000100404",
            "concept": "prestamo"
        },
        "rekon":{
          "amount":1,
          "clientId":"6516e779be74bcbac3394811",
          "nameOrBusinessName": "INDUSTRIAS KIBAN",
          "status": "RECONCILED"
        }
    }
}

Field	Inner Field	Inner Field	Type	Description
created	N/A	N/A	String	Date and time the payment was made
eventType	N/A	N/A	String	Indicates the type of notification you are receiving, the possible values are: PAYMENT. indicates that it is a notification of a new payment
Payment	N/A	/NA	Object	Main object that will contain all the information of the payment received
	id	N/A	String	Identifier assigned by rekon
	paymentMethodType	N/A	String	Indicates the way in which the payment was made. Currently, the only possible value is "speiByKiban".
	speiByKibanDetail	N/A	Object	Object where rekon places the data received from the SPEI transfer
		operationDate	Numeric	Operation date returned by transaction SPEI with format YYYY-MM-DD
		senderInstitution	Numeric	Banking institution from which the payment was made according to the BANXICO institutions catalog.
		senderAccount	String	CLABE account with 18 digits of the person who made the payment.
		senderRFC	String	RFC or CURP of the person who made the payment.
		trackingKey	String	Tracking key assigned by the person who made the SPEI transfer
		amount	Numeric	payment amount
		beneficiaryAccount	String	CLABE account with 18 digits of the person who made the payment.
		concept	String	Concept that defines the person who makes the transfer.
	rekon	N/A	Object	Object with information that is allocated in rekon
		amount	Numeric
		clientId	String	ID of the user who made the payment.
		nameOrBusinessName	String	Name of the person who received the payment according to the financial information of the received account
		status	String	Indicates the payment status. RECONCILED, the payment was made and reconciled satisfactorily