Users

This section provides a list of possible events that can be received as webhooks.

To have the real-time updates between TransFi and Customers, we are configuring the webhook events to be sent to Customers on below events.

StatusDescriptionsWebhook notification
user_createdUser has created the account in TransFiYes
user_approvedUser has created the account in TransFi, and can do demo transactions.Yes
user_rejectedUser has created the account in TransFi, but failed for transaction approval.Yes
kyc_successUploaded details are successfully verified and approved on our KYC Partner and ComplianceYes
kyc_rejectedUploaded details are not approved on our KYC Partner and ComplianceYes

Sample Event For User:

{
    "eventId": "EV-231107XXXXX4387",
    "entityId": "UX-231107XXXXX1115",
    "entityType": "user",
    "status": "user_created",
    "user": {
        "userId": "UX-231107XXXXX1115",
        "firstName": "Nandhirajan",
        "lastName": "Pandiraj",
        "country": "EU",
        "createdAt": "2023-11-08T00:00:00.004+04:00"
    },
    "order": {},
    "partnerContext": {}
}
{
    "eventId": "EV-231107XXXXX4387",
    "entityId": "UX-231107XXXXX1115",
    "entityType": "user",
    "status": "user_rejected",
    "user": {
        "userId": "UX-231107XXXXX1115",
        "firstName": "Nandhirajan",
        "lastName": "Pandiraj",
        "country": "EU",
        "createdAt": "2023-11-08T00:00:00.004+04:00"
    },
    "order": {},
    "partnerContext": "TESTNZZ6WFX"
}
{
    "eventId": "EV-231107XXXXX4387",
    "entityId": "UX-231107XXXXX1115",
    "entityType": "user",
    "status": "user_approved",
    "user": {
        "userId": "UX-231107XXXXX1115",
        "firstName": "Nandhirajan",
        "lastName": "Pandiraj",
        "country": "EU",
        "createdAt": "2023-11-08T00:00:00.004+04:00"
    },
    "order": {},
    "partnerContext": "TESTNZZ6WFX"
}
{
    "eventId": "EV-231107XXXXX4387",
    "entityId": "UX-231107XXXXX1115",
    "entityType": "user",
    "status": "kyc_initiated",
    "user": {
        "userId": "UX-231107XXXXX1115",
        "firstName": "Nandhirajan",
        "lastName": "Pandiraj",
        "country": "EU",
        "createdAt": "2023-11-08T00:00:00.004+04:00"
    },
    "order": {},
    "partnerContext": "TESTNZZ6WFX"
}
{
    "eventId": "EV-231107XXXXX4387",
    "entityId": "UX-231107XXXXX1115",
    "entityType": "user",
    "status": "kyc_success",
    "user": {
        "userId": "UX-231107XXXXX1115",
        "firstName": "Nandhirajan",
        "lastName": "Pandiraj",
        "country": "EU",
        "createdAt": "2023-11-08T00:00:00.004+04:00"
    },
    "order": {},
    "partnerContext": "TESTNZZ6WFX"
}
{
    "eventId": "EV-231107XXXXX4387",
    "entityId": "UX-231107XXXXX1115",
    "entityType": "user",
    "status": "kyc_rejected",
    "user": {
        "userId": "UX-231107XXXXX1115",
        "firstName": "Nandhirajan",
        "lastName": "Pandiraj",
        "country": "EU",
        "createdAt": "2023-11-08T00:00:00.004+04:00"
    },
    "order": {},
    "partnerContext": "TESTNZZ6WFX"
}