Event Types

OUR SOLUTION COUNTRIES CUSTOMERS CONTACT US
Search…
Event Types
Learn all about the webhooks event types.
DLocal supports event notifications for these types of events.
These transaction notifications are sent in near real time as transaction events occur; they contain detailed information about the events.
DLocal platform supports event notifications for these types of events:
​Account status events.
​Card status events.​
​Card transaction events.
​Authorization events.​
​Dispute events.​
​
List of available events
Transaction events
Webhook notification
1
{
2
   "uuid": "ISGW-4-86d652010e3c4a1db61ef6420ebf4197",
3
   "origin": "TRANSACTION_EVENT",
4
   "payload": {
5
      ...
6
   }
7
}
Copied!
Property
Description
uuid
Webhook unique identifier.
origin
Webhook event key.
payload
Webhook event body.
Card transaction events
The following applies to debit/credit transaction events
Webhook origin key = TRANSACTION_EVENT
Webhook payload = Transaction Object​
Example Request
1
{
2
   "uuid": "ISGW-4-86d652010e3c4a1db61ef6420ebf4197",
3
   "origin": "TRANSACTION_EVENT",
4
   "payload": {
5
       "transaction_id": "ISGC-4-1JEqoK2eZvKYlo2CGGaCQ8Xn",
6
       "status": "APPROVED",
7
       "description": "Deposit",
8
       "type": "credit",
9
       "created_date": "2021-03-10T10:02:21.898Z",
10
       "amount": 5126,
11
       "currency": "COP",
12
       "card_id": "",
13
       "card_acceptor": {
14
           "mid": "",
15
           "mcc": "",
16
           "name": "",
17
           "zip_code": "",
18
           "state": "",
19
           "street": "",
20
           "city": "",
21
           "country": ""
22
       }
23
   }
24
}
Copied!
You may specify “ALL” key to enable all events.
Authorization events
Authorization
A request will be sent to your server to approve or reject the transaction.
Webhook origin key = AUTHORIZATION
Webhook payload = Authorization Object​
1
{
2
   "uuid": "ISGW-4-86d652010e3c4a1db61ef6420ebf4197",
3
   "origin": "AUTHORIZATION",
4
   "payload": {
5
      	"card_id" : "ISGC-1111-1111-1111",
6
	"account_id" : "ISGA-1111-1111-1111",  
7
	"transaction_id" : "123456",
8
	"entry_mode" : "05",
9
	"processing_code" : "00",
10
	"created_date" : "2020-06-22",
11
	"created_time" : "11:05",
12
	"amount_merchant" : 110,
13
	"currency_merchant" : "ARS",
14
	"amount_compensation" 1,
15
	"currency_compensation" : "USD",
16
	"amount_billing": 110,
17
	"currency_billing" : "ARS",
18
	"card_acceptor" : {
19
		"mid" : "1234",
20
		"mcc" : "12",
21
		"name" : "Walmart",
22
		"country" : "AR",
23
		"state" : "BA",
24
		"city" : "105",
25
		"street": "Calle Moreno Nro 134",
26
		"zip_code" : "1900"
27
	},
28
	"conversion":{
29
                   "amount": 1,
30
                   "currency": "USD",
31
                   "exchange_rate": 110
32
 	}
33
   }
34
}
Copied!
​
Failed Authorization
A request will be sent to your server to notify that a transaction processing error has occurred.
Webhook origin key = FAILED_AUTHORIZATION
Webhook payload = Fail Authorization Object​
1
{
2
   "uuid": "ISGW-4-86d652010e3c4a1db61ef6420ebf4197",
3
   "origin": "FAILED_AUTHORIZATION",
4
   "payload": {
5
      	"card_id" : "ISGC-1111-1111-1111",
6
	"account_id" : "ISGA-1111-1111-1111",  
7
	"transaction_id" : "123456",
8
	"fail_type" : "TIME_OUT"
9
	}
10
   }
11
}
Copied!
Account Events
A request will be sent to your server to inform you updates on your account status.
Webhook notification
1
{
2
 "origin" : "ACCOUNT",
3
 "uuid" : "ISGW-4-dasidnaio312kln12n4",
4
 "payload": {
5
     "account_uid": "ISGA-4-1JEqoK2eZvKYlo2CGGaCQ8Xn",
6
     "account_reference" : "My account 1",
7
     "status": "ACTIVE",
8
     "status_code": "300",
9
     "status_detail": "The account is active.", 
10
     "previous_status" : "WAITING_FOR_OTP_PHONE",
11
     "created_date":"2021-03-10T10:02:21.898Z",
12
     "update_date": "2021-03-10T10:02:21.898Z",
13
 }
14
}
Copied!
Property
Text
origin
Webhook event key.
uuid
Webhook unique identifier.
payload
Webhook event body.
account_uid
Account identifier. 
account_reference
Merchant reference to identify the account.
status
Account status.
status_code
Account status code.
status_detail
Account status description.
previous_status
Account previous status.
update_date
Time in which the status has changed.
Card Events
A request will be sent to your server to inform you updates on your card status.
Webhook
1
{
2
  "origin": "CARD",
3
  "uuid": "ISGW-4-dasidnaio312kln12n4",
4
  "payload": {
5
    "card_id": "ISGC-4-1JEqoK2eZvKYlo2CGGaCQ8Xn",
6
    "card_reference": "card test",
7
    "account_id": "ISGA-4-1JEqoK2eZvKYlo2CGGaCQ8Xn",
8
    "status": "ACTIVE",
9
    "status_code": "302",
10
    "status_detail": "The card is active.",
11
    "previous_status": null,
12
    "created_date": "2022-01-16T09:38:16.786Z",
13
    "update_date": "2022-01-16T09:38:16.786Z",    
14
  },  
15
}
Copied!
Dispute Events
A request will be sent to your server to inform you updates on your disputes status.
Webhook
1
{
2
  "origin": "DISPUTE",
3
  "uuid": "ISGW-4-dasidnaio312kln12n4",
4
  "payload": {
5
    "merchant_reference": "test 1",
6
    "dispute_id": "ISGD-4-c6b0ca07820041ffbbd8db010b1d01d9",
7
    "status": "IN_DISPUTE",
8
    "status_code": "201",
9
    "status_detail": "Waiting for the issuer to answer.",
10
    "previous_status": "DISPUTE_RECEIVED",
11
    "created_date": "2022-01-16T09:38:16.786Z",
12
    "update_date": "2022-02-01T08:47:18.685Z",
13
    "dispute_evidence": {
14
      "owner_has_card": false,
15
      "dispute_type": "FRAUD",
16
      "dispute_subtype": "STOLEN_CARD_TRANSACTIONS",
17
      "dispute_explanation": "someone stole my card and made a purchase"
18
    },
19
    
20
  },
21
  
22
}
Copied!
Webhooks
Disputes
Last modified 6d ago
Copy link
Contents
List of available events
Transaction events
Card transaction events