Banktransfer Initiated (DBT)

Setup the configuration

Before you can start you need to request one or more Virtual IBANs.

The Flow

Payload DBT Exchange (POST)

We will send you an exchange call with some information. We will use in the Exchange URL

POST /ipn/receive?type=dbt&id=XXXXXXXXXXXXX&event=transaction

{
    "event": "transaction",
    "type": "dbt",
    "version": 1,
    "id": "VM-XXXX-XXXX-XXXX",
    "object": {
        "id": "VM-XXXX-XXXX-XXXX",
        "date": "2024-10-28",
        "description": "FULL_USER_DESCRIPTION",
        "guid": "Bank identification ID",
      	"type": "credit", // "credit" or "debit"
        "amount": {
            "value": 10,
            "currency": "EUR"
        },
        "collector": {
            "method": "iban",
            "iban": {
                "owner": "PAY.XXXXX",
                "iban": "NL000000000000",
                "bic": ""
            }
        },
        "payer": {
            "method": "iban",
            "iban": {
                "owner": "John Doe",
                "iban": "NL000000000000",
                "bic": ""
            }
        }
    }
}

Allowed Resultset

If you like to create an order for this payment, you can use the standard order Object.

{
    "serviceId": "SL-XXXX-XXXX",  //Must be from the merchant or related via a aliance/partner connection
    "description": "Manual ORDER",
    "reference": "REF1234",
    "order": {
        "countryCode": "NL",
        "deliveryDate": "2024-01-01",
        "invoiceDate": "2024-01-01",
        "deliveryAddress": {
            "firstName": "FirstName",
            "lastName": "LastName",
            "street": "street",
            "streetNumber": "10",
            "streetNumberAddition": "a",
            "zipCode": "1122 AA",
            "city": "Amsterdam",
            "country": "NL",
            "region": "ZH"
        },
        "invoiceAddress": {
            "firstName": "FirstName",
            "lastName": "LastName",
            "street": "street",
            "streetNumber": "10",
            "streetNumberAddition": "a",
            "zipCode": "1122 AA",
            "city": "Amsterdam",
            "country": "NL",
            "region": "ZH"
        },
        "products": [
            {
                "id": "invoice-1234",
                "description": "invoice-1234",
                "type": "invoice",
                "price": {
                    "value": 150,
                    "currency": "EUR"
                },
                "quantity": 1.00,
                "vatPercentage": 21.00
            }
        ]
    },
    "customer": {
        "email": "[email protected]",
        "firstName": "firstName",
        "lastName": "lastName",
        "birthDate": "1999-01-01",
        "gender": "M",
        "phone": "0612345678",
        "locale": "nl_NL",
        "trust": "0",
        "reference": "customerID",
        "gaClientId": "ga....",
        "company": {
            "name": "company name",
            "cocNumber": "...",
            "vatNumber": "...",
            "country": "NL"
        }
    },
    "stats": {
        "tool": "tool",
        "info": "info",
        "object": "object",
        "extra1": "extra1",
        "extra2": "extra2",
        "extra3": "extra3",
        "domainId": "domainId",
        "promotorId": "promotorId"
    },
    "transferData": {
      "key": "value"
    }
}