1. Webhooks
Payswix | Agents API
  • Finance account
    • Getting started
    • Validation rules
    • Virtual IBANs
      • NACE codes
      • Create vIBAN for person or company
      • Get a list of vIBANs
    • Transactions
      • Create a SEPA transfer
      • Get transfer fee
      • Get all existing recipients
      • Get transaction information
      • Get a filtered list of transactions
    • Companies
      • Get specific company details
    • Accounts
      • Create a new account
      • Get all user accounts
      • Get user account information by account number
    • Other
      • Check if the server is alive
    • Webhooks
      • Transaction webhook
    • Schemas
      • Company vIBAN
      • Person vIBAN
      • Transaction
  • Standard account
    • Transactions
      • Create a SEPA transfer
      • Create a SWIFT transfer
    • Schemas
      • Transaction
  1. Webhooks

Transaction webhook

Developing
Webhook
POST
transaction
A webhook allows your application to receive real-time event notifications from a service through HTTP callbacks. When a transaction is sent or received, the system sends an HTTP request to a configured endpoint URL. Webhook is sent in JSON format and you can see an example structure below.

Request

Authorization
Add parameter in header
{{apiKey}}
Example:
{{apiKey}}: ********************
Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-server.com' \
--header '{{apiKey}}: <api-key>' \
--header 'Content-Type: application/json' \
--data '{}'
Response Response Example
{
    "transaction": {
        "amount": "-1.04",
        "bankDetails": {
            "bankAccountNumber": "NL90INGB6670867398",
            "bankAddress": null,
            "bankCode": null,
            "bankCountryCode": "NL",
            "bankName": "ING BANK N.V.",
            "beneficiaryAdditionalCode": null,
            "beneficiaryAddress": null,
            "beneficiaryCity": null,
            "beneficiaryCode": null,
            "beneficiaryCountryCode": null,
            "beneficiaryName": "Test Beneficiary 2",
            "beneficiaryPostalCode": null,
            "beneficiaryState": null,
            "beneficiaryTaxCode": null,
            "bic": "INGBNL2AXXX",
            "correspondentBankAccountNumber": null,
            "correspondentBankCode": null,
            "correspondentBankName": null,
            "remitterAddress": "sdd",
            "remitterCity": "sad",
            "remitterCountryCode": "AT",
            "remitterPostalCode": null,
            "remitterState": null,
            "sortCode": null
        },
        "beneficiaryAccountIban": "NL90INGB6670867398",
        "beneficiaryAccountNumber": null,
        "beneficiaryName": "Test Beneficiary 2",
        "beneficiaryType": 0,
        "chargeType": null,
        "clientId": "eaaa63f0-f9ea-4ad6-8a32-1361f845bdb9",
        "clientName": "Jonast Jonaitis",
        "createdAt": "2026-03-05T11:55:09+00:00",
        "currency": "EUR",
        "currencyType": 1,
        "description": "lQK5Vq1idP202603051354",
        "directDebitMandateId": null,
        "directDebitPaymentId": null,
        "fees": [],
        "fromAccountIban": "LT773880003386656756",
        "id": "a8563ccf-61bc-4130-beb6-48b3328d7ee5",
        "issuedCardHoldTransactionId": null,
        "partnerId": null,
        "processingTime": null,
        "provider": "litas_sepa_sct",
        "providerId": null,
        "providerType": "sepa",
        "remitterAccountNumber": "82286655756",
        "remitterName": "Jonas Jonaitis",
        "settlementDate": "2026-03-05T00:00:00+00:00",
        "state": 7,
        "status": 1,
        "type": 4,
        "updatedAt": "2026-03-05T11:55:10+00:00"
    },
    "type": "transaction.completed"
}
Previous
Check if the server is alive
Next
Company vIBAN
Built with