v1
latestOpenAPI 3.1.02026-08-06236494759.4 KBWebhooks
Transactions
Transaction - Joule Feed
A Transaction has been settled/reversed.
postWebhookjoule_feed
Headers
X-Soldo-Fingerprintstring required
Webhook authentication: SHA512SUM of the fingerprint values listed in the fingerprint order for this webhook.
Example:{{fingerprint}}
X-Soldo-Fingerprint-Orderstring required
Webhook authentication: The order of the values used to calculate the fingerprint.
Example:id, walletId, status, transactionSign
X-Soldo-Fingerprint-Signaturestring required
Webhook authentication: Signature of the X-Soldo-Fingerprint. It must be verified using the Soldo public key.
Example:{{fingerprint_signature}}
Payload
Example payload
{
"event_uuid": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"company_account_id": "XMPL1234",
"data": {
"id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"wallet_id": "6853e657-c797-4985-8d6b-5425d4e51df8",
"wallet_name": "John Doe",
"purchase_id": "6853e657-c797-4985-8d6b-5425d4e51df8",
"amount": 10.25,
"tx_amount": 10.25,
"fee_amount": 10.25,
"exchange_rate": 1,
"auth_exchange_rate": 1,
"expense_date": "2017-06-01T12:48:40Z",
"expense_reviewer": "XMPL1234-000001",
"expense_approved_amount": 10.25,
"expense_report_id": "c861cc24-6663-410f-8c78-73f886fff4ef",
"date": "2017-06-01T12:48:40Z",
"settlement_date": "2017-06-01T12:48:40Z",
"update_time": "2017-06-01T12:48:40Z",
"merchant": {
"name": "SHH HOTEL LONDON",
"raw_name": "SHERLOCK HOLMES HOTEL LONDON GBR"
},
"merchant_category": {
"description": "Travel",
"mcc_description": "Lodging - Hotels, Motels, Resorts - not elsewhere classified",
"code": "Lodging - Hotels, Motels, Resorts - not elsewhere classified",
"sub_category": "Hotels"
},
"tags": [
{
"id": "2d65bd5e-3fdf-4002-b166-bde7fb8863fa",
"dictionary_id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"dictionary": "ExampleTagDictionary",
"tag": "tx-label",
"code": "CODE tag",
"visible": true,
"description": "Label to mark transactions"
}
],
"card_id": "6853e657-c797-4985-8d6b-5425d4e51df8",
"masked_pan": "123456******1234",
"owner_name": "John",
"owner_surname": "Smith",
"owner_id": "XMPL1234-000003",
"custom_reference_id": "123456-user-1",
"group_id": "2d65bd5e-3fdf-4002-b166-bde7fb8863fa",
"trx_owner_id": "XMPL1234-000003",
"metadata_ids": [
"express"
],
"fuel_details": {
"plate": "AA000BB",
"vat_deductibility_percentage": "40%",
"mileage": 125000,
"quantity": 80,
"unit_price": 1.41,
"invoice_id": 4421109,
"invoice_number": "NVC112200987",
"invoice_date": "2017-06-01T12:48:40Z",
"invoice_total_amount": 10.25,
"invoice_row": 4,
"invoice_row_amount": 10.25,
"dri": "DRI00099881",
"vehicle_id": "6853e657-c797-4985-8d6b-5425d4e51df8"
},
"vat_percentage": 15,
"vat_amount": 10.25,
"flags": [
"forUser"
],
"payment_method_id": "6853e657-c797-4985-8d6b-5425d4e51df8",
"expense_category": {
"id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"name": "category-one",
"description": "An expense category",
"tax_rate_id": "c861cc24-6663-410f-8c78-73f886fff4ef",
"expense_type": "TRAVEL_AND_ENTERTAINMENT",
"integration": "Netsuite",
"creation_time": "2017-06-01T12:48:40Z",
"last_update_time": "2017-06-01T12:48:40Z"
},
"tax_rate": {
"id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"code": "code-vat-11",
"name": "Tax 11",
"description": "Number 11 of Tax code",
"percentage": 15,
"enabled": true,
"integration": "something",
"creation_time": "2017-06-01T12:48:40Z",
"last_update_time": "2017-06-01T12:48:40Z"
},
"tx_id": "5-857211147-150603333585014265",
"payment_trn_code": "1234567890123456789012345678IT",
"invoice": {
"number": "INV-2023-001",
"date": "2023-01-23",
"po_number": "PO-2023-001"
},
"source": {
"name": "J. Doe",
"destination_wallet_id": "de29bffb-7da2-40f1-934a-241170762d3e",
"destination_wallet_name": "EURO VIBAN"
},
"custom_export": [
{
"product": "SAP",
"export_date": "2017-06-01T12:48:40Z"
}
],
"out_spending_policy": {
"approved_amount": {
"amount": 10.25
},
"rejected_amount": {
"amount": 10.25
}
},
"card_name": "CardName",
"split_transactions": [
{
"amount": {
"amount": 10.25
},
"vat_amount": {
"amount": 10.25
},
"line_number": 1,
"tags": [
{
"id": "2d65bd5e-3fdf-4002-b166-bde7fb8863fa",
"dictionary_id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"dictionary": "ExampleTagDictionary",
"tag": "tx-label",
"code": "CODE tag",
"visible": true,
"description": "Label to mark transactions"
}
],
"employee": {
"id": "XMPL1234-000001",
"name": "John",
"surname": "Smith",
"middlename": "John",
"dob": "1970-10-21",
"job_title": "Business Strategist",
"department": "Research & Development",
"email": "jdoe@fake.soldo.com",
"mobile": "+44123323232",
"mobile_prefix": "+44",
"custom_reference_id": "123456-user-1",
"visible": true,
"mobile_access": true,
"web_access": true,
"groups": [
"7bf79328-a7ae-4222-aa54-091ff7f429a7",
"2d65bd5e-3fdf-4002-b166-bde7fb8863fa"
],
"shipping_address": {
"id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"recipient": "JohnSmith",
"name": "Foo Street 75",
"line1": "Bar Street 64",
"line2": "Other street 31",
"country": "GB",
"county": "LD",
"city": "London",
"post_code": "00000",
"delivery_phone_number": "+441234567890",
"type": "SHIPPING",
"creation_time": "2017-06-01T12:48:40Z",
"last_update": "2017-06-01T12:48:40Z"
},
"reports_to": "XMPL1234-000001",
"roles": [
{
"id": "superAdmin",
"name": "superAdmin",
"description": "The SuperAdmin role",
"scope": "ALL"
}
],
"contact_id": "135fdb6c-2e77-4fc0-a79f-2453fde75ef7",
"creation_time": "2017-06-01T12:48:40Z",
"last_update": "2017-06-01T12:48:40Z"
},
"expense_category": {
"id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"name": "category-one",
"description": "An expense category",
"tax_rate_id": "c861cc24-6663-410f-8c78-73f886fff4ef",
"expense_type": "TRAVEL_AND_ENTERTAINMENT",
"integration": "Netsuite",
"creation_time": "2017-06-01T12:48:40Z",
"last_update_time": "2017-06-01T12:48:40Z"
},
"tax_rate": {
"id": "7bf79328-a7ae-4222-aa54-091ff7f429a7",
"code": "code-vat-11",
"name": "Tax 11",
"description": "Number 11 of Tax code",
"percentage": 15,
"enabled": true,
"integration": "something",
"creation_time": "2017-06-01T12:48:40Z",
"last_update_time": "2017-06-01T12:48:40Z"
},
"approved_amount": {
"amount": 10.25
},
"rejected_amount": {
"amount": 10.25
}
}
],
"timeline": [
{
"created_at": "2017-06-01T12:48:40Z",
"amount": 10.25,
"balance_after": {
"available_amount": 10.25,
"pending_amount": 10.25,
"ledger_amount": 10.25
},
"balance_before": {
"available_amount": 10.25,
"pending_amount": 10.25,
"ledger_amount": 10.25
},
"is_fee": true
}
]
},
"subscription_id": "2d65bd5e-3fdf-4002-b166-bde7fb8863fa"
}Response
Success.