Understand how you will receive notifications from rekon
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 |