Skip to main content
POST
/
v1
/
debtors
/
{id}
/
bankaccounts
Add bank account to a debtor
curl --request POST \
  --url https://api.paywise.de/v1/debtors/{id}/bankaccounts/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "iban": "<string>",
  "bic": "<string>"
}
'
{
  "href": "<string>",
  "acting_as": "consumer",
  "addresses": [
    {
      "street": "<string>",
      "zip": "<string>",
      "city": "<string>",
      "country": "AF"
    }
  ],
  "created": "2023-11-07T05:31:56Z",
  "updated": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "your_reference": "<string>",
  "person": {
    "first_name": "<string>",
    "last_name": "<string>",
    "salutation": "<string>",
    "birth_date": "2023-12-25",
    "death_date": "2023-12-25"
  },
  "organization": {
    "name": "<string>"
  },
  "communication_channels": [
    {
      "type": "email",
      "value": "<string>"
    }
  ],
  "bank_accounts": [
    {
      "iban": "<string>",
      "bic": "<string>"
    }
  ],
  "metadata": [
    {
      "type": "user:reference",
      "value": "<string>"
    }
  ],
  "events": [
    {
      "type": "registration",
      "title": "<string>",
      "occurence": "2023-11-07T05:31:56Z",
      "your_reference": "<string>",
      "description": "<string>",
      "location": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Body

​
iban
string
required
Required string length: 1 - 34
​
bic
string | null
Maximum string length: 255

Response

201 - application/json
​
href
string<uri>
required
​
acting_as
required

Tell us if the debtor is either a consumer or a business/other organization. Single-person-business debtors must have the value business

  • consumer - Verbraucher
  • business - Unternehmer
Available options:
consumer,
business
​
addresses
object[]
required
​
created
string<date-time>
required
​
updated
string<date-time>
required
​
id
string
​
your_reference
string | null
Maximum string length: 255
​
person
object

If the debtor is a natural person or a single-person-business please provide this object. In case of a single-person-business, please set acting_as to business

​
organization
object

If the debtor is an organization (no single-person-business), please provide this object. For single-person-business debtors see the person field.

​
communication_channels
object[]
​
bank_accounts
object[]
​
metadata
object[]
​
events
object[]