Appearance
Are you an LLM? You can read better optimized documentation at /guide/acquiring/events.md for this page in Markdown format
Events
This article lists the webhooks you may receive when using the Acquiring feature.
For the legacy flow, the reception of any payin webhook meant that a payment had been accepted. This is no longer the case in the newest version. Please refer to the payinStatus attribute of the payin. The payment is accepted when valued to VALIDATED.
Webhooks flow chart
TopupCard events
topupCard.validate
json
{
"webhook": "topupCard.validate",
"webhook_created_at": 16867326126402,
"object_id": "61e46d74-54db-4170-968f-28c307ba255c",
"object": "topupCard",
"object_payload": {
"topupCards": [
{
"topupCardId": "61e46d74-54db-4170-968f-28c307ba255c",
"userId": "1656177",
"profile": "00001340585",
"token": "4d2e3ce0aa972bb3726fa609b648535c803d725dccf3d8cbe738762f84281d3e",
"brand": "MASTERCARD",
"maskedPan": "545454xxxxxx5454",
"cardHolder": "Tom Pes",
"cardExpiryMonth": "12",
"cardExpiryYear": "2025",
"issuer": "CENTRAL TRUST BANK, THE",
"country": "US",
"domesticNetwork": null,
"cardType": "CREDIT",
"status": "VALIDATED",
"createdDate": "2023-06-14 10:50:08",
"updatedDate": "2023-06-14 10:50:08"
}
]
},
"webhook_id": "185cf5c2-766d-4168-8848-6bd754083ef4",
"object_payload_signature": "CktrgqtW2rknbedybQ3VIDTxygjZRE3zrY6dR\/g3YpE=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
topupCard.cancel
json
{
"webhook": "topupCard.cancel",
"webhook_created_at": 16867326507819,
"object_id": "61e46d74-54db-4170-968f-28c307ba255c",
"object": "topupCard",
"object_payload": {
"topupCards": [
{
"topupCardId": "61e46d74-54db-4170-968f-28c307ba255c",
"userId": "1656177",
"profile": "00001340585",
"token": "4d2e3ce0aa972bb3726fa609b648535c803d725dccf3d8cbe738762f84281d3e",
"brand": "MASTERCARD",
"maskedPan": "545454xxxxxx5454",
"cardHolder": "Tom Pes",
"cardExpiryMonth": "12",
"cardExpiryYear": "2025",
"issuer": "CENTRAL TRUST BANK, THE",
"country": "US",
"domesticNetwork": null,
"cardType": "CREDIT",
"status": "CANCELED",
"createdDate": "2023-06-14 10:50:08",
"updatedDate": "2023-06-14 10:50:50"
}
]
},
"webhook_id": "c69a1148-ea41-479c-a33d-af0df5e95f72",
"object_payload_signature": "fn\/rOnp3\/YWJFodXHIRUzMmKmT82ohYIqapwcRG5VvI=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
Authorization events
authorization.create
json
{
"webhook": "authorization.create",
"webhook_created_at": 16867327260694,
"object_id": "7ec56e11-02fe-5f53-a7e9-d8403e95bbe5",
"object": "authorization",
"object_payload": {
"authorizations": [
{
"authorizationId": "7ec56e11-02fe-5f53-a7e9-d8403e95bbe5",
"walletId": "878744",
"userId": "1656177",
"authorizationStatus": "PENDING",
"messageToUser": "The financial institution has approved the payment.",
"amount": "100.00",
"currency": "EUR",
"createdDate": "2023-06-14 10:51:56",
"walletEventName": "Hondwallet",
"walletAlias": "Hondwallet-620e13cb0760f",
"userFirstname": "John",
"userLastname": "Doe",
"codeStatus": "150116",
"informationStatus": "Authorized",
"payinDate": "0000-00-00 00:00:00",
"additionalData": "{\"card\":{\"externalProvider\":{\"transactionReference\":\"800240081686\"}}}"
}
]
},
"webhook_id": "65ad7aad-2c72-4abd-920d-e73107afcf78",
"object_payload_signature": "d6u1VgSn+hWZHpb4Z2nfbwm3\/RtyAVdsyS3CTD0+Qc8=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
authorization.update
json
{
"webhook": "authorization.update",
"webhook_created_at": 16867328446792,
"object_id": "7ec56e11-02fe-5f53-a7e9-d8403e95bbe5",
"object": "authorization",
"object_payload": {
"authorizations": [
{
"authorizationId": "7ec56e11-02fe-5f53-a7e9-d8403e95bbe5",
"walletId": "878744",
"userId": "1656177",
"authorizationStatus": "PENDING",
"messageToUser": "Authorization cancellation requested.",
"amount": "100.00",
"currency": "EUR",
"createdDate": "2023-06-14 10:51:56",
"walletEventName": "Hondwallet",
"walletAlias": "Hondwallet-620e13cb0760f",
"userFirstname": "John",
"userLastname": "Doe",
"codeStatus": "150175",
"informationStatus": "Authorization Cancellation Requested",
"payinDate": "0000-00-00 00:00:00",
"additionalData": "{\"card\":{\"externalProvider\":{\"transactionReference\":\"800240081686\"}}}"
}
]
},
"webhook_id": "c9e92612-6780-4fb0-871e-137158a870a3",
"object_payload_signature": "wa9DCqC1wj0XKBmexQSmwlu1lZbi8Vvl+t277sxDTGs=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
authorization.cancel
json
{
"webhook": "authorization.cancel",
"webhook_created_at": 16867328881913,
"object_id": "7ec56e11-02fe-5f53-a7e9-d8403e95bbe5",
"object": "authorization",
"object_payload": {
"authorizations": [
{
"authorizationId": "7ec56e11-02fe-5f53-a7e9-d8403e95bbe5",
"walletId": "878744",
"userId": "1656177",
"authorizationStatus": "CANCELED",
"messageToUser": "Merchant cancelled the payment attempt.",
"amount": "100.00",
"currency": "EUR",
"createdDate": "2023-06-14 10:51:56",
"walletEventName": "Hondwallet",
"walletAlias": "Hondwallet-620e13cb0760f",
"userFirstname": "John",
"userLastname": "Doe",
"codeStatus": "150115",
"informationStatus": "Canceled",
"payinDate": "0000-00-00 00:00:00",
"additionalData": "{\"card\":{\"externalProvider\":{\"transactionReference\":\"800240081686\"}}}"
}
]
},
"webhook_id": "40ca0506-00c8-469f-b5c1-d0016bcc277f",
"object_payload_signature": "\/h8+\/ekdSsDHYSsmyJaQmP75XJT8Il7wOJ5PutVqmeY=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
Payin events
payin.create
json
{
"webhook": "payin.create",
"webhook_created_at": 17232080879509,
"object_id": "ddd4a268-ac2a-5359-afa1-2c1c92ed83c5",
"object": "payin",
"object_payload": {
"payins": [
{
"payinId": "ddd4a268-ac2a-5359-afa1-2c1cxxed83c5",
"payinTag": "",
"walletId": "878744",
"userId": "1656177",
"payinStatus": "PENDING",
"paymentMethodId": "25",
"messageToUser": "A capture request has been sent to the financial institution.",
"subtotalItems": "0.00",
"subtotalServices": "0.00",
"subtotalTax": "0.00",
"amount": "12.48",
"currency": "EUR",
"createdDate": "2024-08-09 14:54:38",
"walletEventName": "reset",
"walletAlias": "alias878744",
"userFirstname": "Alex",
"userLastname": "Oak",
"codeStatus": "150117",
"informationStatus": "Capture Requested",
"refundAmount": null,
"ibanId": null,
"ibanFullname": null,
"DbtrIBAN": null,
"ibanBic": null,
"ibanTxEndToEndId": null,
"ibanTxId": null,
"forwardUrl": null,
"paymentAcceptedUrl": null,
"paymentRefusedUrl": null,
"paymentWaitingUrl": null,
"paymentExceptionUrl" null,
"payinDate": "0000-00-00 00:00:00",
"mandateId": "0",
"creditorName": null,
"creditorAddressLine": null,
"creditorCountry": null,
"creditorIban": null,
"creditorBIC": null,
"virtualIbanId": null,
"virtualIbanReference": null,
"additionalData": "{\"card\":{\"externalProvider\":{\"state\":\"completed\",\"mid\":\"00001340255\",\"authorizationCode\":\"no_code\",\"transactionReference\":\"800315441134\",\"dateCreated\":\"2024-08-09T14:54:38+0200\",\"dateUpdated\":\"2024-08-09T14:54:43+0200\",\"status\":117,\"message\":\"Capture Requested\",\"authorizedAmount\":12.48,\"capturedAmount\":12.48,\"refundedAmount\":0,\"currency\":\"EUR\",\"ipAddress\":\"0.0.0.0\",\"ipCountry\":\"\",\"cdata1\":\"212707\",\"cdata2\":\"878744\",\"cdata3\":\"1656177\",\"cdata4\":\"\",\"cdata5\":\"\",\"cdata6\":\"\",\"cdata7\":\"\",\"cdata8\":\"\",\"cdata9\":\"\",\"cdata10\":\"\",\"eci\":\"9\",\"paymentProduct\":\"mastercard\",\"paymentMethod\":{\"pan\":\"545454******5454\",\"cardHolder\":\"ALEX OAK\",\"token\":\"5d******63\",\"issuer\":\"TREE BANK, THE\",\"brand\":\"MASTERCARD\",\"country\":\"US\",\"cardExpiryMonth\":\"12\",\"cardExpiryYear\":\"2025\"},\"fraudScreening\":{\"scoring\":\"0\",\"result\":\"not_launched\",\"review\":\"\"}}}}"
}
]
},
"webhook_id": "a58d8791-2e74-4b04-8351-6b421931f80e",
"object_payload_signature": "SItdZHqCRm64kHVlcNsf/7Txxvuj6/tC274xFq4p6BU="
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
payin.update
json
{
"webhook": "payin.update",
"webhook_created_at": 17232080901832,
"object_id": "ddd4a268-ac2a-5359-afa1-2c1c92ed83c5",
"object": "payin",
"object_payload": {
"payins": [
{
"payinId": "ddd4a268-ac2a-5359-afa1-2c1c92ed83c5",
"payinTag": "",
"walletId": "878744",
"userId": "1656177",
"payinStatus": "VALIDATED",
"paymentMethodId": "25",
"messageToUser": "The financial institution has processed the payment.",
"subtotalItems": "0.00",
"subtotalServices": "0.00",
"subtotalTax": "0.00",
"amount": "12.48",
"currency": "EUR",
"createdDate": "2024-08-09 14:54:38",
"walletEventName": "reset",
"walletAlias": "alias878744",
"userFirstname": "Alex",
"userLastname": "Oak",
"codeStatus": "150118",
"informationStatus": "Captured",
"refundAmount": null,
"ibanId": null,
"ibanFullname": null,
"DbtrIBAN": null,
"ibanBic": null,
"ibanTxEndToEndId": null,
"ibanTxId": null,
"forwardUrl": null,
"paymentAcceptedUrl": null,
"paymentRefusedUrl": null,
"paymentWaitingUrl": null,
"paymentExceptionUrl": null,
"paymentCanceledUrl": null,
"payinDate": "0000-00-00 00:00:00",
"mandateId": "0",
"creditorName": null,
"creditorAddressLine": null,
"creditorCountry": null,
"creditorIban": null,
"creditorBIC": null,
"virtualIbanId": null,
"virtualIbanReference": null,
"additionalData": "{\"card\":{\"externalProvider\":{\"state\":\"completed\",\"mid\":\"00001340255\",\"authorizationCode\":\"no_code\",\"transactionReference\":\"800315441134\",\"dateCreated\":\"2024-08-09T14:54:38+0200\",\"dateUpdated\":\"2024-08-09T14:54:43+0200\",\"status\":118,\"message\":\"Captured\",\"authorizedAmount\":12.48,\"capturedAmount\":12.48,\"refundedAmount\":0,\"currency\":\"EUR\",\"ipAddress\":\"0.0.0.0\",\"ipCountry\":\"\",\"cdata1\":\"212707\",\"cdata2\":\"878744\",\"cdata3\":\"1656177\",\"cdata4\":\"\",\"cdata5\":\"\",\"cdata6\":\"\",\"cdata7\":\"\",\"cdata8\":\"\",\"cdata9\":\"\",\"cdata10\":\"\",\"eci\":\"9\",\"paymentProduct\":\"mastercard\",\"paymentMethod\":{\"pan\":\"545454******5454\",\"cardHolder\":\"ALEX OAK\",\"token\":\"5d******63\",\"issuer\":\"TREE BANK, THE\",\"brand\":\"MASTERCARD\",\"country\":\"US\",\"cardExpiryMonth\":\"12\",\"cardExpiryYear\":\"2025\"},\"fraudScreening\":{\"scoring\":\"0\",\"result\":\"not_launched\",\"review\":\"\"}}}}"
}
]
},
"webhook_id": "e45a778a-12b5-49fd-8646-28d127ba68f8",
"object_payload_signature": "KuAWRSGPPEIwLmMuowh5cxxEucsyAri3zIH4ZxwsDTM="
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
payin.cancel
json
{
"webhook": "payin.cancel",
"object_id": "248c79b7-fc5e-5c32-96b3-c434fd0d2639",
"object": "payin",
"object_payload": {
"payins": [
{
"payinId": "248c79b7-fc5e-5c32-96b3-c434fd0d2639",
"payinTag": "",
"walletId": "878744",
"userId": "1656177",
"payinStatus": "CANCELED",
"paymentMethodId": 25,
"messageToUser": "",
"subtotalItems": "0.00",
"subtotalServices": "0.00",
"subtotalTax": "0.00",
"amount": "20",
"currency": "EUR",
"createdDate": "2021-09-17T09:32:49+00:00",
"walletEventName": "Wallet",
"walletAlias": "alias",
"userFirstname": "Louis",
"userLastname": "Pinsard",
"codeStatus": "150113",
"informationStatus": "The financial institution refused to authorize the payment.",
"refundAmount": null,
"ibanId": null,
"ibanFullname": null,
"DbtrIBAN": null,
"ibanBic": null,
"ibanTxEndToEndId": null,
"ibanTxId": null,
"forwardUrl": null,
"paymentAcceptedUrl": null,
"paymentRefusedUrl": null,
"paymentWaitingUrl": null,
"paymentExceptionUrl": null,
"paymentCanceledUrl": null,
"payinDate": "2021-09-17T11:32:49+02:00",
"mandateId": "0",
"creditorName": null,
"creditorAddressLine": null,
"creditorCountry": null,
"creditorIban": null,
"creditorBIC": null,
"virtualIbanId": null,
"virtualIbanReference": null,
"additionalData": {
"card": {
"externalProvider": {
"transaction_reference": "mock_385371f00f004d42"
}
}
}
}
]
},
"webhook_id": "d6d58cd7-46d6-4159-bab6-48cae27a1a6a",
"object_payload_signature": "Ze1KRBH5EzV+56h9LCq048ECU3WiXiIPxrFJDgPBWA0=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
PayinRefund events
payinrefund.create
json
{
"webhook": "payinrefund.create",
"webhook_created_at": 16426047629673,
"object_id": "b457966e-6cf9-5d1d-8483-45425cfc8101",
"object": "payinrefund",
"object_payload": {
"payinrefunds": [
{
"payinrefundId": "b457966e-6cf9-5d1d-8483-45425cfc8101",
"payinrefundTag": null,
"payinrefundStatus": "PENDING",
"payinrefundDate": "2022-01-19 16:06:01",
"walletId": "971021",
"payinId": "29b4e8a8-0abc-5a24-8405-808c5eb34835",
"amount": "5",
"currency": "EUR",
"createdDate": "2022-01-19 16:04:11",
"modifiedDate": "2022-01-19 16:06:00",
"userId": "1778843",
"codeStatus": "150124",
"informationStatus": "A refund request has been sent to the financial institution.",
"reasonTms": null
}
]
},
"webhook_id": "935260ff-dd91-466c-9148-f27364db0857",
"object_payload_signature": "oFj6BWt8N4dSU7j6lamfBJoxqS0l1AczQzbRvyBwTY4=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
payinrefund.update
json
{
"webhook": "payinrefund.update",
"webhook_created_at": 16426049523256,
"object_id": "b457966e-6cf9-5d1d-8483-45425cfc8101",
"object": "payinrefund",
"object_payload": {
"payinrefunds": [
{
"payinrefundId": "b457966e-6cf9-5d1d-8483-45425cfc8101",
"payinrefundTag": null,
"payinrefundStatus": "VALIDATED",
"payinrefundDate": "2022-01-19 16:09:09",
"walletId": "971021",
"payinId": "29b4e8a8-0abc-5a24-8405-808c5eb34835",
"amount": "5",
"currency": "EUR",
"createdDate": "2022-01-19 16:04:11",
"modifiedDate": "2022-01-19 16:09:07",
"userId": "1778843",
"codeStatus": "150126",
"informationStatus": "The payment was partially refunded.",
"reasonTms": null
}
]
},
"webhook_id": "e81865f8-4258-488c-b960-28035fa5c665",
"object_payload_signature": "76H1+eZsgCU\/2VrhUOES0CgFQARZPRCXX6b\/NCv2sAg=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
payinrefund.cancel
json
{
"webhook": "payinrefund.cancel",
"webhook_id": "701629730",
"object": "payinrefund",
"object_id": "7dd5d61b-22db-404f-9899-d473109a6aad",
"object_payload": {
"payinrefunds": [
{
"payinrefundId": "7dd5d61b-22db-404f-9899-d473109a6aad",
"payinrefundTag": null,
"payinrefundStatus": "CANCELED",
"walletId": "366026",
"payinId": "6455658",
"payinrefundDate": "0000-00-00",
"amount": "921.00",
"currency": "EUR",
"createdDate": "2021-05-10 09:20:07",
"modifiedDate": "2021-06-01 11:30:11",
"codeStatus": "170003",
"informationStatus": "",
"reasonTms": null
}
]
},
"object_payload_signature": "pdbm9lmV2Q5ggl4EAugoT4\/HWGScmS6umv251CsBn0A="
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Chargeback events
card.acquiring.chargeback.create
json
{
"webhook": "card.acquiring.chargeback.create",
"object_id": "0b1787dc-02f6-5c6f-a559-cb033d6890a0",
"object": "card.acquiring",
"object_payload": {
"chargebacks": [
{
"userId": "1656177",
"walletId": "878744",
"payinId": "be17c043-9287-50b2-8fb2-188546dfc72a",
"transactionReference": "10",
"payinrefundId": "0b1787dc-02f6-5c6f-a559-cb033d6890a0",
"payinMethodId": 25,
"paymentBrand": "mastercard",
"currency": "EUR",
"amount": "20",
"country": "CA",
"isRefunded": false,
"chargebackReason": "",
"payinCreatedDate": "2021-08-10 15:33:50",
"chargebackCreatedDate": "2021-08-16 11:38:45",
"payinRefundCreatedDate": null
}
]
},
"webhook_id": "48902d9b-bb04-4698-ae26-46ba6fb6233c",
"object_payload_signature": "HDkynjtisOCPOcHeD8t7Kz6Le+UBBEvjmrBJTBGPESU=",
"auth_key": "true"
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29