PayPro API Reference (v1)

Servers

https://api.paypro.nl/

Payments

Operations

Refunds

Operations

Chargebacks

Operations

Pay methods

Operations

Customers

Operations

Retrieves a customer

Request

Retrieves a single customer based on the id.

Path

idstringrequired

Responses

customer found

Bodyapplication/json

idstringrequired

Example: "CU7JRN6W6K3DA9"

typestringrequired

Value"customer"

Example: "customer"

emailstring or null(email)required

Example: "customer@paypro.nl"

first_namestring or nullrequired

Example: "firstname"

last_namestring or nullrequired

Example: "name"

addressstring or nullrequired

Example: "address 2"

postalstring or nullrequired

Example: "1234AA"

citystring or nullrequired

Example: "city"

countrystring or nullrequired

Example: "NL"

vat_numberstring or nullrequired

Example: "vatnumber"

company_namestring or nullrequired

Example: "PayPro"

phone_numberstring or nullrequired

Example: "012345679"

created_atstring(date-time)required

Example: "2022-12-31T23:00:00Z"

_linksobjectrequired

Example: {"self":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9"}

_links.selfstring(uri)required

Example: "https://api.paypro.nl/customers/CU7JRN6W6K3DA9"

Response

application/json

{
  "id": "CU7JRN6W6K3DA9",
  "type": "customer",
  "email": "customer@paypro.nl",
  "first_name": "firstname",
  "last_name": "name",
  "address": "address 2",
  "postal": "1234AA",
  "city": "city",
  "country": "NL",
  "vat_number": "vatnumber",
  "company_name": "PayPro",
  "phone_number": "012345679",
  "created_at": "2022-12-31T23:00:00Z",
  "_links": {
    "self": "https://api.paypro.nl/customers/CU7JRN6W6K3DA9"
  }
}

Updates a customer

Request

Updates a Customer object. Returns the updated Customer.

Path

idstringrequired

Bodyapplication/json

emailstring or null

Customer's email address

Example: "customer@paypro.nl"

first_namestring or null

Customer's first name

Example: "firstname"

last_namestring or null

Customer's last name

Example: "name"

addressstring or null

Customer's address

Example: "address 2"

postalstring or null

Customer's postal code or ZIP

Example: "1234AA"

citystring or null

Customer's city

Example: "city"

countrystring or null

Customer's country in ISO-3166-1 alpha-2 format, example: 'NL'

Example: "NL"

vat_numberstring or null

Customer's company vat number

Example: "vatnumber"

company_namestring or null

Customer's company name

Example: "PayPro"

phone_numberstring or null

Customer's phone number

Example: "012345679"

Responses

customer found

Bodyapplication/json

idstringrequired

Example: "CU7JRN6W6K3DA9"

typestringrequired

Value"customer"

Example: "customer"

emailstring or null(email)required

Example: "customer@paypro.nl"

first_namestring or nullrequired

Example: "firstname"

last_namestring or nullrequired

Example: "name"

addressstring or nullrequired

Example: "address 2"

postalstring or nullrequired

Example: "1234AA"

citystring or nullrequired

Example: "city"

countrystring or nullrequired

Example: "NL"

vat_numberstring or nullrequired

Example: "vatnumber"

company_namestring or nullrequired

Example: "PayPro"

phone_numberstring or nullrequired

Example: "012345679"

created_atstring(date-time)required

Example: "2022-12-31T23:00:00Z"

_linksobjectrequired

Example: {"self":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9"}

_links.selfstring(uri)required

Example: "https://api.paypro.nl/customers/CU7JRN6W6K3DA9"

Response

application/json

{
  "id": "CU7JRN6W6K3DA9",
  "type": "customer",
  "email": "customer@paypro.nl",
  "first_name": "firstname",
  "last_name": "name",
  "address": "address 2",
  "postal": "1234AA",
  "city": "city",
  "country": "NL",
  "vat_number": "vatnumber",
  "company_name": "PayPro",
  "phone_number": "012345679",
  "created_at": "2022-12-31T23:00:00Z",
  "_links": {
    "self": "https://api.paypro.nl/customers/CU7JRN6W6K3DA9"
  }
}

Retrieves a list of customers

Request

Retrieve a list of customers that have been created for your account. The customers are sorted, with the most recent first.

Responses

customers found

Bodyapplication/json

typestringrequired

Value"list"

dataArray of objects(customer)required

Example: [{"id":"CU7JRN6W6K3DA9","type":"customer","email":"customer@paypro.nl","first_name":"firstname","last_name":"name","address":"address 2","postal":"1234AA","city":"city","country":"NL","vat_number":"vatnumber","company_name":"PayPro","phone_number":"012345679","created_at":"2022-12-31T23:00:00Z","_links":{"self":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9"}}]

data[].idstringrequired

Example: "CU7JRN6W6K3DA9"

data[].typestringrequired

Value"customer"

Example: "customer"

data[].emailstring or null(email)required

Example: "customer@paypro.nl"

data[].first_namestring or nullrequired

Example: "firstname"

data[].last_namestring or nullrequired

Example: "name"

data[].addressstring or nullrequired

Example: "address 2"

data[].postalstring or nullrequired

Example: "1234AA"

data[].citystring or nullrequired

Example: "city"

data[].countrystring or nullrequired

Example: "NL"

data[].vat_numberstring or nullrequired

Example: "vatnumber"

data[].company_namestring or nullrequired

Example: "PayPro"

data[].phone_numberstring or nullrequired

Example: "012345679"

data[].created_atstring(date-time)required

Example: "2022-12-31T23:00:00Z"

data[]._linksobjectrequired

Example: {"self":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9"}

data[]._links.selfstring(uri)required

Example: "https://api.paypro.nl/customers/CU7JRN6W6K3DA9"

countintegerrequired

_linksobjectrequired

_links.selfstring(uri)required

_links.nextstring(uri)

_links.prevstring(uri)

Response

application/json

{
  "type": "list",
  "data": [
    { … }
  ],
  "count": 0,
  "_links": {
    "self": "http://example.com",
    "next": "http://example.com",
    "prev": "http://example.com"
  }
}

Mandates

Operations

Subscriptions

Operations

Subscription periods

Operations

Installment plans

Operations

Installment plan periods

Operations

Events

Operations

Webhooks

Operations