Use our webhooks

Search…

Use our webhooks

Webhooks notify you in real-time of anything happening in your project. Instead of having to rely on the next batch to detect new events, we let you know as soon as they happen.

If you want to know how to configure a webhook, read the documentation. In this guide we will focus on different use cases and which event to use.
A new user has opened an account
To detect that a user has opened an account you should primarily use the onboarding redirectUrl. We will redirect the user with the state you specified when creating the onboarding so that you can easily reconciliate which user ha  finished their onboarding. If you use generic onboarding URLs, you can subscribe to the Account.Created webhook and you will be notified when a user completes onboarding. In order to determine which user it was, you can use this query. It allows you to get the personal user information and compare it to what you have in your database.
Request
Response
1
query MyQuery {
2
  account(accountId: "{{YOUR_ACCOUNT_ID}}") {
3
    holder {
4
      info {
5
        ... on AccountHolderIndividualInfo {
6
          __typename
7
          user {
8
            id
9
          }
10
        }
11
      }
12
    }
13
    memberships {
14
      edges {
15
        node {
16
          legalRepresentative
17
          user {
18
            id
19
            lastName
20
          }
21
        }
22
      }
23
    }
24
  }
25
}
Copied!
​
1
{
2
  "data": {
3
    "account": {
4
      "holder": {
5
        "info": {}
6
      },
7
      "memberships": {
8
        "edges": [
9
          {
10
            "node": {
11
              "legalRepresentative": true,
12
              "user": {
13
                "id": "2f90e409-fae7-40f6-af47-6320f31c5bd9",
14
                "lastName": "Doe"
15
              }
16
            
17
          }
18
        ]
19
      }
20
    }
21
  
22
​
Copied!
​Try it now on the API Explorer​
A SEPA payment was received
Receiving a payment will trigger a Transaction.Booked event. You will then have to do a query to check if the transaction was a payment received. This information is available in transaction.type, where it will be equal to SepaCreditTransferIn. Here is an example of the query you can execute to verify it's a received payment.
A SEPA payment was sent
This works the same way as SEPA payment received, but with SepaCreditTransferOut
A user added a card
Every time a user adds a card a Card.Created event will be triggered. Using the card query you can then fetch the accountMembership or the account linked to it.
A card payment was accepted
To be informed every time a card payment was accepted you have to use the Transaction.Pending event and the Transaction.Booked event. The first one covers 99% of cases where a user makes a payment and the merchant asks for authorization of the full amount. In this case, a query like this will allow you to determine that it is a card authorization. If the type is CardOut and the status is Pending, then the authorization went through. The other 1% we will only receive a debit for the payment. The Transaction type will be CardOut but the status will be Booked.
A card payment was refused
This works the same way as accepted card payments, but the status will be Rejected.
Next steps
To get more details about how webhooks work please read the documentation.

Guide - Previous

Giving access to accounts

Next - Guide

Capital Deposit

Last modified 2mo ago

Export as PDF

Copy link

Contents

A new user has opened an account

A SEPA payment was received

A SEPA payment was sent

A user added a card

A card payment was accepted

A card payment was refused

Next steps