Platforms notifications

Notifications will be sent when the status of account changes.

The notifications will be delivered to the notification_url sent in the account creation request.

Until dLocal receives a 200 status code confirmation on these notifications, it will retry once an hour for 7 days.

Signature Notifications

An HMAC signature is calculated using a request's key-value pairs and a secret key, which is known only to you and dLocal. By verifying this signature, you'll confirm that the notification was not modified during transmission.

dLocal will be signing each POST notification using the same method described on the Security section (HMAC-SHA256 hash function).

Simply take the Signature HTTP header from the notification, and compare it with the one generated by you using your X-Login and secretKey, and the X-Date and Request body of the notification received. If the signature generated by you matched the one received on the Signature HTTP header, then it is safe to assume that this is a valid message from dLocal.

Request Fields

Body FieldTypeDescription
event_typeStringNotification type. For example: ACCOUNT_STATUS_UPDATE, PRICING_LEVEL_UPDATE, INDUSTRY_UPDATE, INSTALLMENTS_RESPONSIBLE_UPDATE or CAPABILITIES_STATUS_UPDATE.
account_idStringdLocal account ID.
account_external_referenceStringAccount external ID.
status_codeNumberAccount status code.
notification_dateDate (ISO-8601)Notification’s timestamp.
payloadObjectNotification payload may vary between notification types. Please see details.

Example request

{
   "account_id":"d907f733-5e17-4470-b963-c2ac2c11a440",
   "event_type": "ACCOUNT_STATUS_UPDATE",
   "account_external_reference":"2352362346",
   "notification_date":"2021-07-12T13:07:08.000Z",
   "payload": {
               "last_updated":"2021-07-12T13:07:08.000Z",
               "status":"APPROVED",
               "status_code": 200,
               "status_detail": "approved"
   }
}
{
   "account_id":"d907f733-5e17-4470-b963-c2ac2c11a440",
   "event_type": "PRICING_LEVEL_UPDATE",
   "account_external_reference":"2352362346",
   "notification_date":"2021-07-12T13:07:08.000Z",
   "payload": {
               "last_updated":"2021-07-12T13:07:08",
               "new_price_level": "freemium",
               "new_settlement_period": 7,
               "old_price_level": "smbs_1",
               "old_settlement_period": 14
   }
}
{
   "account_id":"d907f733-5e17-4470-b963-c2ac2c11a440",
   "event_type": "INDUSTRY_UPDATE",
   "account_external_reference":"2352362346",
   "notification_date":"2021-07-12T13:07:08.000Z",
   "payload": {
               "last_updated":"2021-07-12T13:07:08",
               "new_industry_type": "PLAN_AHORA_INDUMENTARIA",
               "old_industry_type": "PLAN_AHORA_OTHER"
   }
}
{
   "account_id":"d907f733-5e17-4470-b963-c2ac2c11a440",
   "event_type": "INSTALLMENTS_RESPONSIBLE_UPDATE",
   "account_external_reference":"2352362346",
   "notification_date":"2021-07-12T13:07:08.000Z",
   "payload": {
               "last_updated":"2021-07-12T13:07:08",
               "new_installment_responsible": "CUSTOMER",
               "old_installment_responsible": "MERCHANT"
   }
}
{
   "account_id":"d907f733-5e17-4470-b963-c2ac2c11a440",
   "event_type": "CAPABILITIES_STATUS_UPDATE",
   "account_external_reference":"2352362346",
   "notification_date":"2021-07-12T13:07:08.000Z",
   "payload": {
      "capabilities": [
        {
        "capability_name": "PAYINS",
        "capability_status": "DISABLED",
        "restrictions": [
                {
                    "requested_by": "by_fraud",
                    "date": "2023-12-06"
                },
                {
                    "requested_by": "by_legal",
                    "date": "2023-12-01"
                }
            ]

      },
        {
          "capability_name": "SETTLEMENTS",
          "capability_status": "ENABLED"
        },
        {
          "capability_name": "REFUNDS",
          "capability_status": "ENABLED"
        },
        {
          "capability_name": "PAYOUTS",
          "capability_status": "ENABLED"
        }
      ],
      "last_updated": "2024-01-09T14:47:48.48458398Z"
    }
}