Webhooks
8 min
A webhook is an HTTP request, triggered by an event in a source system and sent to a destination system, usually with a payload of data. Webhooks are automated, in other words they are automatically sent out when their event is fired in the source system.
You can use webhook notifications to listen for events on your CabCard account so your integration can automatically trigger actions.
Webhook endpoints
A webhook endpoint defines:
- a complete endpoint URL, for example https://api.your-company.com/webhooks/cabcard
- the event types you wish to receive webhook notifications for
- which account the webhook notifications will be sent for
Each webhook endpoint also has its own signature secret which you can use to verify incoming webhook notifications.
CabCard currently supports webhook notifications for the following events:
- sale.created
- intent.authorized
Webhooks can be attached at the submerchant (driver) level, or the operator (fleet) level. You can set up a new webhook endpoint in the Developer Tools section of your online dashboard (either my.cabcard.services or fleets.cabcard.services).
Please note that your URL must be prefixed by https. We are unable to set up localhost addresses for testing purposes. We recommend using a tool like Ngrok during development.
Verifying Webhooks
We recommend you verify incoming webhook notifications, especially if you intend to take actions based on these webhooks which might have a financial impact, for example crediting a driver's account. This is to help prevent abuse and fraud.
After your webhook endpoint has been set up, we will provide you with a signing secret. This should be stored safely within your application (for example, in environment variables), and should not be exposed publicly.
All webhooks will be sent with a signature header Webhook-Signature. The header value will include a timestamp tsp and a SHA256 hash digest sig in the following format:
Webhook-Signature:tsp=1602514909,sig=b46852fb83db1d391b988aa28b0c9857adb7fe1658571edb5cd43040ba87ac56To verify a webhook:
- Extract the timestamp and signatures from the header. Split the header, using the , character as the separator, to get a list of elements. Then split each element, using the = character as the separator, to get a prefix and value pair. The value for the prefix tsp corresponds to the timestamp, and sig corresponds to the signature (or signatures). You can discard any other elements.
- Prepare the signed payload string. This is accomplished by conactenating: the timestamp (as a string), the character ., the actual JSON payload (i.e. the request body) as a string.
- Determine the expected signature. Compute an HMAC with the SHA256 hash function. Use your endpoint’s signing secret as the key, and use the signed payload string from step 2 as the message.
- Compare the signature in the header to the expected signature. If they don't match, don't proceed.
A code sample for verifying webhook signatures is shown below:
const crypto = require('crypto');
const signingSecret = '379985ecf2af498787d207e6a6f0a007'; // secret for your webhook endpoint
const payload = `{"example":"test-purposes-only"}`; // incoming payload, ensure this is the raw payload string, not a parsed version
const header = `tsp=1602514909,sig=4bf8d21b30bc20372d11c38960947901dba598a4640b3ae37d025b08b108dd52`; // value from the HTTP header
// parse the header to get timestamp and signature
const parsedHeader = {};
header.split(",").forEach((item) => {
const element = item.split('=');
parsedHeader[element[0]] = element[1];
});
// prepare signed payload string: concatenate timestamp and JSON payload string
const signedPayloadString = `${parsedHeader.tmp}.${payload}`;
// compute an HMAC using SHA256 hash function. Use signing secret as the key.
const hash = crypto.createHmac('sha256', signingSecret).update(signedPayloadString).digest('hex');
if (hash === parsedHeader.sig) {
// OK to proceed
console.log('Signature verified');
} else {
// Do not proceeed
console.log('Signature not verified');
Your webhook endpoint
For each event occurrence, CabCard will send a POST request containint the webhook data to your endpoint URL in JSON format. The full event details are included and can be used directly after parsing the JSON. Therefore, your webhook endpoint needs to expect data through a POST request and confirm successful receipt of that data.
To acknowledge receipt of an event, your endpoint must return a 2xx HTTP status code to the originating server. All response codes outside this range, including 3xx codes, indicate to that you did not receive the event.
If a 2xx HTTP status code is not received, the notification attempt will be repeated, with retries attempted in an exponential backoff fashion. After multiple failures to send the notification, the event will be marked as failed and further sends will not be attempted. After multiple days without receiving any 2xx HTTP status code responses, the endpoint will be considered as misconfigured and automatically disabled. You will need to fix the problem and re-enable the endpoint.
Because properly acknowledging receipt of the webhook notification is so important, your endpoint should return a 2xx HTTP status code prior to any complex logic that could cause a timeout.
You can use the developer tools section of your CabCard dashboard to view all notification attempts for a given endpoint.
It is advisable to make the webhook request operation on youre integration idempotent, as you may receive the same webhook notification more than once. In this scenario, you would want to ensure that your response to a webhook request is not duplicated.
In addition, we cannot guarantee that event webhook notifications will be delivered within a particular time window (although our system attempts to deliver notifications as soon as possible). Therefore we recommend that your integration should not be time-sensitive.
Event types
All events share a common format, with specific event types containing certain properties.
The webhook request body will contain the following properties:
- id String - a unique identifier for the object
- type String - the event type, for example sale.created, submerchant.updated, payout.updated
- createdAt String - date and time of the event creation, in ISO 8601 format, for example 2020-10-11T22:44:30.652Z
- data Object - data associated with this event.
Detailed information about the data field for the most commonly used events are found below.
Event: sale.created
The data property will contain the following properties:
- sale Object - sale transaction associated with this event
- submerchant Object - submerchant associated with this event (if sale is allocated to a submerchant)
- balanceTransaction Object - balance transaction associated with this event
Depending on the method used to accept this payment (POS, E-commerce or SoftPOS) the following additional properties may be included:
- terminal Object - terminal associated with this event if sale was carried out using a POS terminal (sale property method has value pos).
- intent Object - payment intent associated with this event if sale arose from a completed payment intent (sale property method has value ecommerce).
Example: webhook notification payload for ecommerce (payment link) transaction:
{
"id":"evt_a8z8mxqklms0np8t",
"type":"sale.created",
"createdAt":"2023-09-20T17:26:56.141Z",
"data":{
"sale":{
"id":"sal_example",
"amount":14700,
"saleAmount":14700,
"gratuityAmount":0,
"commissionAmount":0,
"currency":"gbp",
"authCode":"123456",
"retrievalReferenceNumber":"123456789012",
"capturedAt":"2023-09-20T17:26:55.000Z",
"method":"ecommerce",
"interface":"ecommerce",
"cardholderVerificationMethod":"3d_secure",
"terminalSerialNumber":null,
"terminalId":null,
"submerchantId":"sub_example",
"panFirstSix":"412345",
"panLastFour":"1234",
"panLength":16,
"cardScheme":"visa",
"cardBrand":"Visa Classic",
"cardType":"debit",
"cardIssuer":"Example Bank",
"cardIsPrepaid":false,
"cardCountryCode":"GB",
"cardCountryIsInEEA":true,
"cardIsCommercial":false,
"refundedAmount":0,
"status":"approved",
"statusExplanation":null,
"actionCode":"00",
"disbursementWithheld":false,
"receiptSlug":"blue-tree-09",
"balanceTransactionId":"btn_example",
"settlementTransactionId":null,
"createdAt":"2023-09-20T17:26:55.923Z",
"updatedAt":"2023-09-20T17:26:55.923Z",
"refunds":[
],
"disputes":[
],
"receiptId":"rct_example",
"userId":"api_example",
"externalReference":"12345678A"
},
"submerchant":{
"id":"sub_example",
"isActive":true,
"deactivatedAt":null,
"deactivationIsDerogatory":null,
"name":"TaxiCo Limited",
"legalName":"TaxiCo Limited",
"phoneNumber":"+441493331111",
"secondaryPhoneNumber":"",
"emailAddress":"[email protected]",
"websiteUrl":"https://taxico-taxis.co.uk",
"addressLine1":"Example Road",
"addressLine2":"",
"addressLine3":"",
"addressCity":"Example City",
"regionCode":"EXM",
"postcode":"EX10 1AB",
"countryCode":"GB",
"addressLatitude":"52.000000",
"addressLongitude":"1.000000",
"language":"en",
"signatory":{
"role":"Director",
"firstName":"Eric",
"lastName":"Example",
"dateOfBirth":"1980-01-01",
"addressLine1":"18 Example Avenue",
"addressLine2":"",
"addressLine3":"",
"addressCity":"Exampleton",
"regionCode":"EXM",
"postcode":"EX10 1AB",
"countryCode":"GB"
},
"significantOwners":[
{
"firstName":"Eric",
"lastName":"Example",
"dateOfBirth":"1980-01-01",
"addressLine1":"18 Example Avenue",
"addressLine2":"",
"addressLine3":"",
"addressCity":"Exampleton",
"regionCode":"EXM",
"postcode":"EX10 1AB",
"countryCode":"GB"
},
],
"reference":"",
"note":null,
"payoutsWithheld":false,
"businessType":"llc_private",
"businessRegistrationNumber":"09876543",
"merchantCategoryCode":"4121",
"amexSellerReference":"99999999999999999999",
"createdAt":"2023-03-07T11:18:53.202Z",
"updatedAt":"2023-03-08T11:10:34.917Z",
"paymentFacilitatorId":"pfc_example",
"operatorId":"opr_example",
"planAttachment":{
"id":"pat_example",
"startDate":"2023-03-01",
"activationDate":"2023-03-07",
"endDate":null,
"billingSourceId":"placeholder-billing-source",
"payoutDestinationId":"pba_example",
"createdBy":null,
"createdAt":"2023-03-07T11:20:04.194Z",
"updatedAt":"2023-03-07T11:20:04.194Z",
"merchantId":null,
"planId":"pla_example",
"submerchantId":"sub_example",
"plan":{
"id":"pla_example",
"name":"Example plan",
"createdBy":"usr_example",
"createdAt":"2021-02-11T16:29:52.765Z",
"updatedAt":"2023-01-18T15:52:30.205Z",
"accountId":"acc_example",
"processingAgreementId":"agp_example",
"billingAgreementId":"agb_example",
"payoutAgreementId":"agd_example",
"billingAgreement":{
"type":"billing",
"id":"agb_example",
"name":"Billing agreement example name",
"currency":"gbp",
"charges":[
],
"createdBy": "usr_example",
"createdAt":"2021-02-11T16:29:52.768Z",
"updatedAt":"2021-02-11T16:29:52.768Z",
"accountId":"acc_example"
},
"processingAgreement":{
"type":"processing",
"id":"agp_example",
"name":"Processing agreement example name",
"currency":"gbp",
"rates":{
"american_express":{
"type":"percentage",
"value":0.025
},
"card_fallback":{
"type":"percentage",
"value":0.015
},
"decline":{
"type":"flat",
"value":10
},
"dispute":{
"type":"flat",
"value":1500
},
"ecommerce_authorisation":{
"type":"flat",
"value":10
},
"ecommerce_commercial_credit_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_commercial_credit_non_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_commercial_debit_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_commercial_debit_non_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_consumer_credit_european":{
"type":"percentage",
"value":0.015
},
"ecommerce_consumer_credit_non_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_consumer_debit_european":{
"type":"percentage",
"value":0.015
},
"ecommerce_consumer_debit_non_european":{
"type":"percentage",
"value":0.025
},
"pos_authorisation":{
"type":"flat",
"value":10
},
"pos_commercial_credit_european":{
"type":"percentage",
"value":0.025
},
"pos_commercial_credit_non_european":{
"type":"percentage",
"value":0.025
},
"pos_commercial_debit_european":{
"type":"percentage",
"value":0.025
},
"pos_commercial_debit_non_european":{
"type":"percentage",
"value":0.025
},
"pos_consumer_credit_european":{
"type":"percentage",
"value":0.015
},
"pos_consumer_credit_non_european":{
"type":"percentage",
"value":0.025
},
"pos_consumer_debit_european":{
"type":"percentage",
"value":0.015
},
"pos_consumer_debit_non_european":{
"type":"percentage",
"value":0.025
}
},
"createdBy":null,
"createdAt":"2021-02-11T16:29:52.768Z",
"updatedAt":"2021-02-11T16:29:52.768Z",
"accountId":"acc_example"
},
"payoutAgreement":{
"type":"payout",
"scheduleNaturalLanguage":"every week on Wednesday",
"id":"agd_example",
"name":"Example payout agreement - paid weekly, £25 min.",
"currency":"gbp",
"schedule":"INTERVAL=1;FREQ=WEEKLY;BYDAY=WE",
"minBalance":2500,
"scheduledPayoutFee":{
"type":"flat",
"value":0
},
"unscheduledPayoutFee":{
"type":"flat",
"value":100
},
"createdBy":null,
"createdAt":"2017-11-21T13:01:36.322Z",
"updatedAt":"2018-12-28T12:07:52.437Z",
"accountId":"acc_example"
}
}
}
},
"intent":{
"statusIsFinal":true,
"clientAccessUrl":"https://pay.cabcard.services/beta?p=int_example&t=404d54a2c0491f2d136204",
"clientAccessQrCode":"data:image/png;base64,example",
"receiptUrl":"https://receipts.cabcard.services/blue-tree-09",
"id":"int_example",
"submerchantId":"sub_example",
"paymentFacilitatorId":"pfc_example",
"reference":"12345678A",
"description":"Prepayment: taxi journey to Luton Airport on 2023-10-30 09:00",
"status":"succeeded",
"statusExplanation":null,
"brandIdentifier":"sub_example",
"brand":{
"payeeName":"TaxiCo Limited",
"smsSenderName":"TaxiCo Limited",
"payeeAvatarUrl":"https://pay.cabcard.services/default-avatar.png",
"processorName":"CabCard Services (UK) Ltd",
"receiptContactInfo":"[email protected]",
"receiptsBaseUrl":"https://receipts.cabcard.services"
},
"currency":"gbp",
"amount":14700,
"saleAmount":14700,
"gratuityAmount":0,
"captureAmount":14700,
"gratuityEnabled":true,
"clientAccessToken":"404d54a2c0491f2d136204",
"customerName":"Nozrul Iqbal",
"customerIpAddress":"91.42.216.200",
"customerIpInfo":null,
"customerDeviceInfo":{
"isYaBrowser":false,
"isAuthoritative":true,
"isMobile":true,
"isMobileNative":false,
"isTablet":false,
"isiPad":false,
"isiPod":false,
"isiPhone":true,
"isiPhoneNative":false,
"isAndroid":false,
"isAndroidNative":false,
"isBlackberry":false,
"isOpera":false,
"isIE":false,
"isEdge":false,
"isIECompatibilityMode":false,
"isSafari":true,
"isFirefox":false,
"isWebkit":false,
"isChrome":false,
"isKonqueror":false,
"isOmniWeb":false,
"isSeaMonkey":false,
"isFlock":false,
"isAmaya":false,
"isPhantomJS":false,
"isEpiphany":false,
"isDesktop":false,
"isWindows":false,
"isLinux":false,
"isLinux64":false,
"isMac":true,
"isChromeOS":false,
"isBada":false,
"isSamsung":false,
"isRaspberry":false,
"isBot":false,
"isCurl":false,
"isAndroidTablet":false,
"isWinJs":false,
"isKindleFire":false,
"isSilk":false,
"isCaptive":false,
"isSmartTV":false,
"isUC":false,
"isFacebook":false,
"isAlamoFire":false,
"isElectron":false,
"silkAccelerated":false,
"browser":"Safari",
"version":"16.6",
"os":"OS X",
"platform":"iPhone",
"geoIp":{
},
"source":"Mozilla/5.0 (iPhone; CPU iPhone OS 16_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.6 Mobile/15E148 Safari/604.1",
"isWechat":false
},
"customerPhoneNumber":"+447712345678",
"customerEmailAddress":"[email protected]",
"customerSmsSent":true,
"customerEmailSent":false,
"customerAddress":null,
"expiresAt":"2023-10-04T17:24:51.547Z",
"succeededAt":"2023-09-20T17:26:55.757Z",
"threeDSecureToken":null,
"cardToken":"X0ZZ9aaac9347bcf47691d6",
"tokenisedCard":{
"token":"X0ZZ9aaac9347bcf47691d6",
"panEnd":"1234",
"panStart":"412345",
"cardScheme":"visa"
},
"cardTokenType":null,
"captureMode":"automatic",
"capturedAt":"2023-09-20T17:26:55.757Z",
"transactionDetails":{
"amount":14700,
"cipher":"c972fd367226428cbb124a7724495779c972fd367226428cbb124a7724495779",
"acquirer":"finaro",
"authCode":"123456",
"currency":"GBP",
"operation":"use_token_capture",
"paymentId":"646f5b94b7a52df1f3637",
"requestId":"4d1cc15149b6ab",
"timestamp":"09/20/2023 17:26:55",
"cardScheme":"visa",
"merchantId":"20009183",
"receiptSlug":"blue-tree-09",
"submerchantId":"893823884734384",
"transactionType":"straight_operation",
"paymentProcessor":"credorax",
"paymentSourceType":"online_order",
"previousResponseId":"916b0740bb50bfaf480f",
"gatewayResponseCode":"0",
"paymentProcessorMid":"C0235423",
"retrievalReferenceNumber":"123456789012",
"operationResultDescription":"Transaction has been executed successfully.",
"sourceGatewayTransactionId":"de5b9f33ee0c4bb5af400b9b177e5ded",
"processingResponseReasonCode":"00",
"paymentProcessorTransactionId":"de5b9f33ee0c4bb5af400b9b177e5ded",
"gatewayResponseCodeDescription":"The transaction has been executed successfully.",
"processingResponseReasonCodeDescription":"Approved or completed successfully"
},
"authorizedAt":"2023-09-20T17:26:50.368Z",
"authorizationDetails":{
"amount":14700,
"cipher":"f86ab7a30f2341739db2bb500e109267f86ab7a30f2341739db2bb500e109267",
"tdsEci":"05",
"tdsCavv":"421cd0b1858b4e2faeabdbd7bed2745f=",
"tdsData":"05:1234567890987654321234567890:none",
"authCode":"123456",
"currency":"GBP",
"operation":"use_token_auth",
"paymentId":"646f5b94b7a52df1f3637",
"requestId":"1fuq2lms0mllv",
"tdsStatus":"authentication_successful",
"tdsVersion":"2.2.0",
"3ds_acstrxid":"5f985d61-bd46-4487-8ffa-086aaff80885",
"tdsValidPayment":"Y",
"tdsTransactionId":"a459fe0c-66ed-4714-b1f7-bdebfd6fdc7e",
"gatewayResponseCode":"0",
"initialTransactionId":"098765432123456",
"paymentAccountReference":"V001001381923939151234567890",
"operationResultDescription":"Transaction has been executed successfully.",
"sourceGatewayTransactionId":"916b0740bb50bfaf480f",
"processingResponseReasonCode":"00",
"gatewayResponseCodeDescription":"The transaction has been executed successfully.",
"tdsDirectoryServerTransactionId":"342af42d-4731-421b-af96-238f4617b5b2",
"processingResponseReasonCodeDescription":"Approved or completed successfully"
},
"verificationDetails":{
"tdsChallengeUrl":"https://x3d-redirect.credorax.net/challenge/request/20009183/e69e5f140ec0e042bc09d8a0b928a47da961",
"completionResult":{
"amount":14700,
"cipher":"f86ab7a30f2341739db2bb500e109267f86ab7a30f2341739db2bb500e109267",
"tdsEci":"05",
"tdsCavv":"421cd0b1858b4e2faeabdbd7bed2745f=",
"tdsData":"05:1234567890987654321234567890:none",
"authCode":"123456",
"currency":"GBP",
"operation":"use_token_auth",
"paymentId":"646f5b94b7a52df1f3637",
"requestId":"1fuq2lms0mllv",
"tdsStatus":"authentication_successful",
"tdsVersion":"2.2.0",
"3ds_acstrxid":"b742fdfe-60fb-4b58-be3a-fcb248098bf3",
"tdsValidPayment":"Y",
"tdsTransactionId":"6c7740da-fb80-4449-a283-17d12e2be900",
"gatewayResponseCode":"0",
"initialTransactionId":"098765432123456",
"paymentAccountReference":"V001001381923939151234567890",
"operationResultDescription":"Transaction has been executed successfully.",
"sourceGatewayTransactionId":"916b0740bb50bfaf480f",
"processingResponseReasonCode":"00",
"gatewayResponseCodeDescription":"The transaction has been executed successfully.",
"tdsDirectoryServerTransactionId":"342af42d-4731-421b-af96-238f4617b5b2",
"processingResponseReasonCodeDescription":"Approved or completed successfully"
},
"verificationMethod":"tds_challenge",
"tdsChallengeUrlExpiresAt":"2023-09-20T17:27:05.791Z"
},
"saleId":"sal_example",
"logs":[
"[2023-09-20T17:24:51.551Z] Created by: api_example",
"[2023-09-20T17:24:53.545Z] Customer SMS sent to: +447712345678",
"[2023-09-20T17:25:11.547Z] Accessed using client access token. IP: 92.40.216.207",
"[2023-09-20T17:25:53.197Z] Saved tokenised card: {\"cardScheme\":\"visa\",\"panStart\":\"412345\",\"panEnd\":\"1234\",\"token\":\"X0ZZ9aaac9347bcf47691d6\"}",
"[2023-09-20T17:25:53.487Z] Requesting payment authorization via FNO",
"[2023-09-20T17:25:53.696Z] Authorization response indicates cardholder authentication required (SCA)",
"[2023-09-20T17:25:53.702Z] Using SCA method: 3D Secure Fingerprint",
"[2023-09-20T17:25:53.724Z] Waiting for 3DS fingerprint data",
"[2023-09-20T17:25:56.297Z] Accessed using client access token. IP: 92.40.216.205",
"[2023-09-20T17:25:57.993Z] Accessed using client access token. IP: 92.40.216.205",
"[2023-09-20T17:26:00.235Z] Accessed using client access token. IP: 92.40.216.205",
"[2023-09-20T17:26:02.097Z] Accessed using client access token. IP: 92.40.216.205",
"[2023-09-20T17:26:04.767Z] Finished waiting for 3DS fingerprint data",
"[2023-09-20T17:26:05.782Z] Fingerprint completion result indicates cardholder authentication required (SCA)",
"[2023-09-20T17:26:05.788Z] Using SCA method: 3D Secure Challenge",
"[2023-09-20T17:26:06.217Z] Accessed using client access token. IP: 92.40.216.205",
"[2023-09-20T17:26:56.062Z] Sale created. ID: sal_example"
],
"createdBy":"api_example",
"createdAt":"2023-09-20T17:24:51.546Z",
"updatedAt":"2023-09-20T17:26:56.062Z"
},
"balanceTransaction":{
"id":"btn_example",
"feeAmount":231,
"netAmount":14469,
"amount":14700,
"currency":"gbp",
"description":"Sale (approved)",
"type":"sale",
"status":"pending",
"fees":[
{
"amount":221,
"currency":"gbp",
"description":"Processing fee",
"type":"psp_fee"
},
{
"amount":10,
"currency":"gbp",
"description":"Authorisation fee",
"type":"psp_fee"
}
],
"sourceId":"sal_example",
"createdAt":"2023-09-20T17:26:55.853Z",
"updatedAt":"2023-09-20T17:26:55.853Z"
}
}
}Example: webhook notification payload for POS (terminal) transaction:
{
"id":"evt_aa1rluklmtawfil",
"type":"sale.created",
"createdAt":"2023-09-21T15:01:25.773Z",
"data":{
"sale":{
"id":"sal_example",
"amount":17000,
"saleAmount":16500,
"gratuityAmount":500,
"commissionAmount":0,
"currency":"gbp",
"authCode":"123456",
"retrievalReferenceNumber":"Av1KeI004534",
"capturedAt":"2023-09-21T15:01:19.000Z",
"method":"pos",
"interface":"contact",
"cardholderVerificationMethod":"offline_pin",
"terminalSerialNumber":"1623116432",
"terminalId":"ter_example",
"submerchantId":"sub_example",
"panFirstSix":"123456",
"panLastFour":"0987",
"panLength":16,
"cardScheme":"visa",
"cardBrand":"Visa Classic",
"cardType":"debit",
"cardIssuer":"Example Bank",
"cardIsPrepaid":false,
"cardCountryCode":"GB",
"cardCountryIsInEEA":true,
"cardIsCommercial":false,
"refundedAmount":0,
"status":"approved",
"statusExplanation":"",
"actionCode":"000",
"disbursementWithheld":false,
"receiptSlug":"green-tree-01",
"balanceTransactionId":"btn_example",
"settlementTransactionId":null,
"createdAt":"2023-09-21T15:01:25.028Z",
"updatedAt":"2023-09-21T15:01:25.028Z",
"refunds":[
],
"disputes":[
],
"userId":null,
"externalReference":null
},
"submerchant":{
"id":"sub_example",
"isActive":true,
"deactivatedAt":null,
"deactivationIsDerogatory":null,
"name":"Example Taxi Company",
"legalName":"TaxiCo Ltd",
"phoneNumber":"+441234567890",
"secondaryPhoneNumber":"",
"emailAddress":"[email protected]",
"websiteUrl":"",
"addressLine1":"11 Example House Road",
"addressLine2":"Example Town",
"addressLine3":"",
"addressCity":"Example",
"regionCode":"EXP",
"postcode":"EX1 9PL",
"countryCode":"GB",
"addressLatitude":"51.00000",
"addressLongitude":"-0.00000",
"language":"en",
"signatory":{
"role":"Manager",
"firstName":"Eric",
"lastName":"Example",
"dateOfBirth":"1980-01-01",
"addressLine1":"11 Example House Road",
"addressLine2":"Example Town",
"addressLine3":"",
"addressCity":"Example",
"regionCode":"EXP",
"postcode":"EX1 9PL",
"countryCode":"GB"
},
"significantOwners":[
{
"firstName":"Eric",
"lastName":"Example",
"dateOfBirth":"1980-01-01",
"addressLine1":"11 Example House Road",
"addressLine2":"Example Town",
"addressLine3":"",
"addressCity":"Example",
"regionCode":"EXP",
"postcode":"EX1 9PL",
"countryCode":"GB"
}
],
"reference":"",
"note":"",
"payoutsWithheld":false,
"businessType":"llc_private",
"businessRegistrationNumber":"12345678",
"merchantCategoryCode":"4121",
"amexSellerReference":"99990001010293948585",
"createdAt":"2021-10-13T10:15:57.406Z",
"updatedAt":"2023-01-16T12:40:32.327Z",
"paymentFacilitatorId":"pfc_example",
"operatorId":"opr_example",
"planAttachment":{
"id":"pat_example",
"startDate":"2023-03-01",
"activationDate":"2023-03-07",
"endDate":null,
"billingSourceId":"placeholder-billing-source",
"payoutDestinationId":"pba_example",
"createdBy":null,
"createdAt":"2023-03-07T11:20:04.194Z",
"updatedAt":"2023-03-07T11:20:04.194Z",
"merchantId":null,
"planId":"pla_example",
"submerchantId":"sub_example",
"plan":{
"id":"pla_example",
"name":"Example plan",
"createdBy":"usr_example",
"createdAt":"2021-02-11T16:29:52.765Z",
"updatedAt":"2023-01-18T15:52:30.205Z",
"accountId":"acc_example",
"processingAgreementId":"agp_example",
"billingAgreementId":"agb_example",
"payoutAgreementId":"agd_example",
"billingAgreement":{
"type":"billing",
"id":"agb_example",
"name":"Billing agreement example name",
"currency":"gbp",
"charges":[
],
"createdBy": "usr_example",
"createdAt":"2021-02-11T16:29:52.768Z",
"updatedAt":"2021-02-11T16:29:52.768Z",
"accountId":"acc_example"
},
"processingAgreement":{
"type":"processing",
"id":"agp_example",
"name":"Processing agreement example name",
"currency":"gbp",
"rates":{
"american_express":{
"type":"percentage",
"value":0.025
},
"card_fallback":{
"type":"percentage",
"value":0.015
},
"decline":{
"type":"flat",
"value":10
},
"dispute":{
"type":"flat",
"value":1500
},
"ecommerce_authorisation":{
"type":"flat",
"value":10
},
"ecommerce_commercial_credit_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_commercial_credit_non_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_commercial_debit_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_commercial_debit_non_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_consumer_credit_european":{
"type":"percentage",
"value":0.015
},
"ecommerce_consumer_credit_non_european":{
"type":"percentage",
"value":0.025
},
"ecommerce_consumer_debit_european":{
"type":"percentage",
"value":0.015
},
"ecommerce_consumer_debit_non_european":{
"type":"percentage",
"value":0.025
},
"pos_authorisation":{
"type":"flat",
"value":10
},
"pos_commercial_credit_european":{
"type":"percentage",
"value":0.025
},
"pos_commercial_credit_non_european":{
"type":"percentage",
"value":0.025
},
"pos_commercial_debit_european":{
"type":"percentage",
"value":0.025
},
"pos_commercial_debit_non_european":{
"type":"percentage",
"value":0.025
},
"pos_consumer_credit_european":{
"type":"percentage",
"value":0.015
},
"pos_consumer_credit_non_european":{
"type":"percentage",
"value":0.025
},
"pos_consumer_debit_european":{
"type":"percentage",
"value":0.015
},
"pos_consumer_debit_non_european":{
"type":"percentage",
"value":0.025
}
},
"createdBy":null,
"createdAt":"2021-02-11T16:29:52.768Z",
"updatedAt":"2021-02-11T16:29:52.768Z",
"accountId":"acc_example"
},
"payoutAgreement":{
"type":"payout",
"scheduleNaturalLanguage":"every week on Wednesday",
"id":"agd_example",
"name":"Example payout agreement - paid weekly, £25 min.",
"currency":"gbp",
"schedule":"INTERVAL=1;FREQ=WEEKLY;BYDAY=WE",
"minBalance":2500,
"scheduledPayoutFee":{
"type":"flat",
"value":0
},
"unscheduledPayoutFee":{
"type":"flat",
"value":100
},
"createdBy":null,
"createdAt":"2017-11-21T13:01:36.322Z",
"updatedAt":"2018-12-28T12:07:52.437Z",
"accountId":"acc_example"
}
}
}
},
"terminal":{
"id":"ter_example",
"manufacturer":"datecs",
"model":"bluePad55_4g",
"serialNumber":"1623116432",
"reference":64329489,
"customReference":"258",
"lastConnectionAt":"2023-09-21T15:01:24.092Z",
"createdAt":"2022-04-01T08:44:41.279Z",
"updatedAt":"2023-09-21T14:38:59.097Z",
"currentAllocation":{
"id":"tal_example",
"endedAt":null,
"createdAt":"2022-04-07T10:15:41.080Z",
"createdBy":"9xsxFTfCaFTFG5gpPf9r68v7Iac8ZOki@clients",
"startedAt":"2022-04-07T10:15:41.007Z",
"updatedAt":"2022-04-07T10:15:41.080Z",
"merchantId":null,
"terminalId":"ter_example",
"depositoryId":null,
"submerchantId":"sub_example"
},
"simCardId":"sim_example"
},
"balanceTransaction":{
"id":"btn_example",
"feeAmount":175,
"netAmount":16825,
"amount":17000,
"currency":"gbp",
"description":"Sale (approved)",
"type":"sale",
"status":"pending",
"fees":[
{
"amount":170,
"currency":"gbp",
"description":"Processing fee",
"type":"psp_fee"
},
{
"amount":5,
"currency":"gbp",
"description":"Authorisation fee",
"type":"psp_fee"
}
],
"sourceId":"sal_example",
"createdAt":"2023-09-21T15:01:24.947Z",
"updatedAt":"2023-09-21T15:01:24.947Z"
}
}
}Event: intent.authorized
This event is triggered when a payment intent in capture mode: manual is authorized. An example webhook payload is available on request.