Developer documentation
HomeLogin
Enterprise API
Enterprise API
  • Authentication
    • Generate a private and a public certificate
    • Create a JWT token using your private key
  • Webhooks
  • Payment methods
    • Openbanking recurring payments
    • Openbanking payments
    • Card not present card payments
  • API reference
    • Payments
    • Payment methods
    • Customers
    • Settlements
    • Profiles
    • Specification
Powered by GitBook
On this page

Was this helpful?

  1. API reference

Customers

PreviousPayment methodsNextSettlements

Was this helpful?

get

Returns the data of the customer

Authorizations
Path parameters
profileIdstringRequired

The id of the profile

customerIdstringRequired

The id of the customer

Responses
200
OK
application/json
404
Resource not found
application/json
get
GET /v1/profiles/{profileId}/customers/{customerId} HTTP/1.1
Host: api.bankingservice.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "id": "text",
  "company": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "text",
  "phone": "318000201068",
  "address": {
    "premise": 58,
    "sub_premise": "A",
    "building": "text",
    "postal_code": "text",
    "thoroughfare": "text",
    "locality": "Hoofddorp",
    "state": "Noord-Holland",
    "country": "NL"
  },
  "created": "2024-09-25T12:01:00.103Z"
}
delete

Deletes the customer

Authorizations
Path parameters
profileIdstringRequired

The id of the profile

customerIdstringRequired

The id of the customer

Responses
200
OK
application/json
400
Invalid request
application/json
delete
DELETE /v1/profiles/{profileId}/customers/{customerId} HTTP/1.1
Host: api.bankingservice.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
{
  "id": "text",
  "company": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "text",
  "phone": "318000201068",
  "address": {
    "premise": 58,
    "sub_premise": "A",
    "building": "text",
    "postal_code": "text",
    "thoroughfare": "text",
    "locality": "Hoofddorp",
    "state": "Noord-Holland",
    "country": "NL"
  },
  "created": "2024-09-25T12:01:00.103Z"
}
  • GET/v1/profiles/{profileId}/customers
  • POST/v1/profiles/{profileId}/customers
  • GET/v1/profiles/{profileId}/customers/{customerId}
  • PUT/v1/profiles/{profileId}/customers/{customerId}
  • DELETE/v1/profiles/{profileId}/customers/{customerId}
get

Returns a paged list of all the customers

Authorizations
Path parameters
partnerIdstringRequired

The id of the partner to retrieve

profileIdstringRequired

The id of the profile

Responses
200
OK
application/json
get
GET /v1/profiles/{profileId}/customers HTTP/1.1
Host: api.bankingservice.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
200

OK

{
  "page": 0,
  "pages": 620,
  "size": 20,
  "count": 12383,
  "data": [
    {
      "id": "text",
      "company": "text",
      "first_name": "text",
      "last_name": "text",
      "email": "text",
      "phone": "318000201068",
      "address": {
        "premise": 58,
        "sub_premise": "A",
        "building": "text",
        "postal_code": "text",
        "thoroughfare": "text",
        "locality": "Hoofddorp",
        "state": "Noord-Holland",
        "country": "NL"
      },
      "created": "2024-09-25T12:01:00.103Z"
    }
  ]
}
post

Creates a customer

Authorizations
Path parameters
profileIdstringRequired

The id of the profile

Body

PSU creation customer type

companystringOptional

Company name

first_namestringOptional

First name of the customer

Example: John
last_namestringOptional

Last name of the customer

Example: Doe
emailstringOptional

Email adderss of the customer

Example: john.doe@gmail.com
phonestringOptionalExample: 318000201068
Responses
200
OK
application/json
400
Invalid request
application/json
post
POST /v1/profiles/{profileId}/customers HTTP/1.1
Host: api.bankingservice.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 274

{
  "company": "text",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@gmail.com",
  "phone": "318000201068",
  "address": {
    "premise": 58,
    "sub_premise": "A",
    "building": "text",
    "postal_code": "text",
    "thoroughfare": "text",
    "locality": "Hoofddorp",
    "state": "Noord-Holland",
    "country": "NL"
  }
}
{
  "id": "text",
  "company": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "text",
  "phone": "318000201068",
  "address": {
    "premise": 58,
    "sub_premise": "A",
    "building": "text",
    "postal_code": "text",
    "thoroughfare": "text",
    "locality": "Hoofddorp",
    "state": "Noord-Holland",
    "country": "NL"
  },
  "created": "2024-09-25T12:01:00.103Z"
}
put

Updates a customer

Authorizations
Path parameters
profileIdstringRequired

The id of the profile

customerIdstringRequired

The id of the customer

Body

PSU creation customer type

companystringOptional

Company name

first_namestringOptional

First name of the customer

Example: John
last_namestringOptional

Last name of the customer

Example: Doe
emailstringOptional

Email adderss of the customer

Example: john.doe@gmail.com
phonestringOptionalExample: 318000201068
Responses
200
OK
application/json
400
Invalid request
application/json
put
PUT /v1/profiles/{profileId}/customers/{customerId} HTTP/1.1
Host: api.bankingservice.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 274

{
  "company": "text",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@gmail.com",
  "phone": "318000201068",
  "address": {
    "premise": 58,
    "sub_premise": "A",
    "building": "text",
    "postal_code": "text",
    "thoroughfare": "text",
    "locality": "Hoofddorp",
    "state": "Noord-Holland",
    "country": "NL"
  }
}
{
  "id": "text",
  "company": "text",
  "first_name": "text",
  "last_name": "text",
  "email": "text",
  "phone": "318000201068",
  "address": {
    "premise": 58,
    "sub_premise": "A",
    "building": "text",
    "postal_code": "text",
    "thoroughfare": "text",
    "locality": "Hoofddorp",
    "state": "Noord-Holland",
    "country": "NL"
  },
  "created": "2024-09-25T12:01:00.103Z"
}