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,
"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\":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
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.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