API Dokumentation

post/api/v1/Psp/beneficiaries

Registers a withdrawal bank account. It starts disabled: confirm it with the user's PIN ({enable}) or the one-time code sent to them ({verify-otp}). Some bank accounts are also checked before they can be paid.

Psp

Parameter

provider

query · string

Optional

version

path · string

Erforderlich

Anforderungstext

{
  "contactType": 0
}

Antworten

200The new bank account.application/json

{
  "id": "2b7d9e41-8c3a-4f6b-a215-7c9e0d3f5a18",
  "name": "Jane Smith",
  "currency": {
    "value": "EUR"
  },
  "createdDate": "2026-10-16T09:00:00Z",
  "isCompanyContact": false,
  "isEnabled": false,
  "identifiers": [
    {
      "name": "Rail",
      "value": "SEPA"
    },
    {
      "name": "IBAN",
      "value": "DE89370400440532013000"
    },
    {
      "name": "BIC",
      "value": "COBADEFFXXX"
    }
  ],
  "approvalStatus": "pending"
}

400The bank account was refused. The body is a message to show the user.application/json
```
"string"
```
401Not authenticated.application/json
```
{}
```
404Unknown method, or it does not use registered bank accounts.application/json
```
{}
```

Starten Sie Ihre Plattform.

Los geht’s.