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:

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!
Last modified 6d ago