v1

latestOpenAPI 3.1.02026-08-06236494759.4 KB
Webhooks
Transactions

Transaction - Transaction Adjustment

A Transaction has been adjusted.

postWebhooktransaction_adjustment

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

event_uuidstring

The webhook unique ID.

event_type'BusinessTrip' | 'Card' | 'Contact' | 'ExpenseReview' | 'Group' | 'OnlineAds' | 'Order' | 'Purchase' | 'Subscription' | 'Transaction' | 'TransactionAttachment' | 'Employee' | 'Vehicle' | 'Wallet'
event_name'business_trip_created' | 'business_trip_updated' | 'business_trip_deleted' | 'card_activated' | 'card_change_status' | 'card_creation' | 'card_destroyed' | 'card_lost' | 'card_replaced' | 'card_stolen' | 'card_label_updated' | 'card_assignee_updated' | 'add_resources_card' | 'add_resources_member' | 'add_resources_wallet' | 'create_group' | 'delete_group' | 'move_resources_card' | 'move_resources_member' | 'move_resources_wallet' | 'remove_resources_card' | 'remove_resources_member' | 'remove_resources_wallet' | 'update_group' | 'store_order_completed' | 'store_order_placed' | 'balanced_transfer' | 'billing' | 'card_authorization' | 'conversion' | 'customer_care_deposit' | 'customer_care_withdraw' | 'edit_tag' | 'inbound_payment' | 'inbound_payment_reversal' | 'internal_transfer' | 'joule_feed' | 'load_failed' | 'load_money' | 'recurring_billing' | 'scheduled_transfer' | 'transaction_adjustment' | 'unload_money' | 'wiretransfer' | 'upload_completed' | 'attachment_delete' | 'new_user' | 'user_status_changed' | 'user_updated' | 'wallet_created' | 'wallet_deleted' | 'vehicle_create' | 'vehicle_update' | 'vehicle_delete' | 'purchase_create' | 'purchase_update' | 'purchase_delete' | 'purchase_redeem_card' | 'created_expense_configuration' | 'disabled_expense_configuration' | 'enabled_expense_configuration' | 'updated_expense_configuration' | 'completed_transactions_import' | 'updated_transaction' | 'change_expense_type' | 'subscription_activated' | 'subscription_created' | 'subscription_updated' | 'subscription_deleted' | 'subscription_assignee_added' | 'subscription_assignee_removed' | 'online_ads_activated' | 'online_ads_created' | 'online_ads_updated' | 'online_ads_deleted' | 'online_ads_assignee_added' | 'online_ads_assignee_removed' | 'transaction_created' | 'transaction_modified' | 'transaction_deleted' | 'transaction_business_trip_linked' | 'transaction_business_trip_unlinked' | 'contact_created' | 'contact_updated' | 'contact_deleted'
company_account_idstring

The company account ID.

subscription_idstring

The webhook subscription ID used to route this event.

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.