PayPro API Reference (v1)

Servers

https://api.paypro.nl/

Payments

Operations

Refunds

Operations

Chargebacks

Operations

Pay methods

Operations

Customers

Operations

Mandates

Operations

Subscriptions

Operations

Pauses a subscription

Request

Pauses a subscription. A paused subscription will no longer create new subscription periods.

You can resume the subscription by calling the /subscriptions/:id/resume endpoint.

Path

idstringrequired

Responses

subscription paused

Bodyapplication/json

idstringrequired

Example: "PSV1QACRO4DSMQT0KK"

typestringrequired

Value"subscription"

Example: "subscription"

descriptionstringrequired

Example: "Test subscription"

subscription_typestring or nullrequired

Value"direct_debit"

Example: "direct_debit"

statestringrequired

Example: "active"

currencystringrequired

Value"EUR"

Example: "EUR"

created_atstring(date-time)required

Example: "2023-07-24T12:40:10Z"

start_atstring or null(date)required

cancel_atstring or null(date)required

customerstring or nullrequired

Example: "CU7JRN6W6K3DA9"

mandatestring or nullrequired

Example: "MD6ULYXJ4HP9RJ"

schedulingstring or null

Enum"manual""automatic"

Example: "automatic"

cancel_periods_on_cancellationboolean

periodobject or nullrequired

Example: {"amount":"1000","vat":"21","multiplier":1,"interval":"month"}

period.amountintegerrequired

Example: "1000"

period.vatnumber[ 0 .. 100 ]required

Example: "21"

period.multiplierintegerrequired

Example: 1

period.intervalstringrequired

Enum"day""week""month""year"

Example: "month"

first_periodobject or nullrequired

Example: {"amount":"1000","vat":"21","multiplier":1,"interval":"month"}

first_period.amountintegerrequired

Example: "1000"

first_period.vatnumber[ 0 .. 100 ]required

Example: "21"

first_period.multiplierinteger

Example: 1

first_period.intervalstring

Enum"day""week""month""year"

Example: "month"

payment_detailsobjectrequired

Example: {"return_url":null,"cancel_url":null}

payment_details.return_urlstring or null(uri)required

payment_details.cancel_urlstring or null(uri)required

metadataobjectrequired

Example: {}

_linksobjectrequired

Example: {"self":"https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK","customer":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9","mandate":"https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"}

_links.selfstring(uri)required

Example: "https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK"

_links.customerstring(uri)

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

_links.mandatestring(uri)

Example: "https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"

_links.checkoutstring(uri)

Response

application/json

{
  "id": "PSV1QACRO4DSMQT0KK",
  "type": "subscription",
  "description": "Test subscription",
  "currency": "EUR",
  "subscription_type": "direct_debit",
  "state": "active",
  "start_at": null,
  "created_at": "2023-07-24T12:40:10Z",
  "cancel_at": null,
  "customer": "CU7JRN6W6K3DA9",
  "mandate": "MD6ULYXJ4HP9RJ",
  "scheduling": "automatic",
  "cancel_periods_on_cancellation": false,
  "period": {
    "amount": "1000",
    "vat": "21",
    "multiplier": 1,
    "interval": "month"
  },
  "first_period": {
    "amount": "1000",
    "vat": "21",
    "multiplier": 1,
    "interval": "month"
  },
  "payment_details": {
    "return_url": null,
    "cancel_url": null
  },
  "metadata": {},
  "_links": {
    "self": "https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK",
    "customer": "https://api.paypro.nl/customers/CU7JRN6W6K3DA9",
    "mandate": "https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"
  }
}

Resumes a paused subscription

Request

Resumes a paused subscription. The paused subscription will return to the active state and will resume creating new subscription periods.

It is not possible to resume a canceled subscription.

Path

idstringrequired

Responses

subscription resumes

Bodyapplication/json

idstringrequired

Example: "PSV1QACRO4DSMQT0KK"

typestringrequired

Value"subscription"

Example: "subscription"

descriptionstringrequired

Example: "Test subscription"

subscription_typestring or nullrequired

Value"direct_debit"

Example: "direct_debit"

statestringrequired

Example: "active"

currencystringrequired

Value"EUR"

Example: "EUR"

created_atstring(date-time)required

Example: "2023-07-24T12:40:10Z"

start_atstring or null(date)required

cancel_atstring or null(date)required

customerstring or nullrequired

Example: "CU7JRN6W6K3DA9"

mandatestring or nullrequired

Example: "MD6ULYXJ4HP9RJ"

schedulingstring or null

Enum"manual""automatic"

Example: "automatic"

cancel_periods_on_cancellationboolean

periodobject or nullrequired

Example: {"amount":"1000","vat":"21","multiplier":1,"interval":"month"}

period.amountintegerrequired

Example: "1000"

period.vatnumber[ 0 .. 100 ]required

Example: "21"

period.multiplierintegerrequired

Example: 1

period.intervalstringrequired

Enum"day""week""month""year"

Example: "month"

first_periodobject or nullrequired

Example: {"amount":"1000","vat":"21","multiplier":1,"interval":"month"}

first_period.amountintegerrequired

Example: "1000"

first_period.vatnumber[ 0 .. 100 ]required

Example: "21"

first_period.multiplierinteger

Example: 1

first_period.intervalstring

Enum"day""week""month""year"

Example: "month"

payment_detailsobjectrequired

Example: {"return_url":null,"cancel_url":null}

payment_details.return_urlstring or null(uri)required

payment_details.cancel_urlstring or null(uri)required

metadataobjectrequired

Example: {}

_linksobjectrequired

Example: {"self":"https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK","customer":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9","mandate":"https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"}

_links.selfstring(uri)required

Example: "https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK"

_links.customerstring(uri)

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

_links.mandatestring(uri)

Example: "https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"

_links.checkoutstring(uri)

Response

application/json

{
  "id": "PSV1QACRO4DSMQT0KK",
  "type": "subscription",
  "description": "Test subscription",
  "currency": "EUR",
  "subscription_type": "direct_debit",
  "state": "active",
  "start_at": null,
  "created_at": "2023-07-24T12:40:10Z",
  "cancel_at": null,
  "customer": "CU7JRN6W6K3DA9",
  "mandate": "MD6ULYXJ4HP9RJ",
  "scheduling": "automatic",
  "cancel_periods_on_cancellation": false,
  "period": {
    "amount": "1000",
    "vat": "21",
    "multiplier": 1,
    "interval": "month"
  },
  "first_period": {
    "amount": "1000",
    "vat": "21",
    "multiplier": 1,
    "interval": "month"
  },
  "payment_details": {
    "return_url": null,
    "cancel_url": null
  },
  "metadata": {},
  "_links": {
    "self": "https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK",
    "customer": "https://api.paypro.nl/customers/CU7JRN6W6K3DA9",
    "mandate": "https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"
  }
}

Retrieves a list subscription periods that belong to this subscription

Request

Retrieves a list of subscription periods that belong to this subscription.

Path

idstringrequired

Responses

subscription periods found

Bodyapplication/json

typestringrequired

Value"list"

dataArray of objects(subscription_period)required

Example: [{"id":"SPD344S1PDY8XX","type":"subscription_period","amount":1500,"period_number":1,"subscription":"PSUJDW4VCMG9JS","state":"paid","payments":{"type":"list","data":[{"id":"PPH25H07JYWLR7PA82","type":"payment","amount":1000,"description":"Test Payment","currency":"EUR","state":"paid","refunded_amount":0,"return_url":"https://example.com/thank-you","cancel_url":"https://example.com/cancel","paid_at":"2023-06-30T12:44:35Z","created_at":"2023-06-30T12:40:10Z","_links":{"self":"https://api.paypro.nl/payments/PPH25H07JYWLR7PA82"}}],"count":1,"_links":{"self":"https://api.paypro.nl/subscription_periods/SPD344S1PDY8XX/payments"}},"created_at":"2023-06-30T12:40:10Z","_links":{"self":"https://api.paypro.nl/subscription_periods/SPD344S1PDY8XX","subscription":"https://api.paypro.nl/subscriptions/PSUJDW4VCMG9JS"}}]

data[].idstringrequired

Example: "SPD344S1PDY8XX"

data[].typestringrequired

Value"subscription_period"

Example: "subscription_period"

data[].amountintegerrequired

Example: 1500

data[].period_numberintegerrequired

Example: 1

data[].subscriptionstringrequired

Example: "PSUJDW4VCMG9JS"

data[].statestringrequired

Enum"open""pending""paid""canceled""reversed""refunded"

Example: "paid"

data[].paymentsobjectrequired

Example: {"type":"list","data":[{"id":"PPH25H07JYWLR7PA82","type":"payment","amount":1000,"description":"Test Payment","currency":"EUR","state":"paid","refunded_amount":0,"return_url":"https://example.com/thank-you","cancel_url":"https://example.com/cancel","paid_at":"2023-06-30T12:44:35Z","created_at":"2023-06-30T12:40:10Z","_links":{"self":"https://api.paypro.nl/payments/PPH25H07JYWLR7PA82"}}],"count":1,"_links":{"self":"https://api.paypro.nl/subscription_periods/SPD344S1PDY8XX/payments"}}

data[].payments.typestringrequired

Value"list"

Example: "list"

data[].payments.dataArray of objects(payment)required

Example: [{"id":"PPH25H07JYWLR7PA82","type":"payment","amount":1000,"description":"Test Payment","currency":"EUR","state":"paid","refunded_amount":0,"return_url":"https://example.com/thank-you","cancel_url":"https://example.com/cancel","paid_at":"2023-06-30T12:44:35Z","created_at":"2023-06-30T12:40:10Z","_links":{"self":"https://api.paypro.nl/payments/PPH25H07JYWLR7PA82"}}]

data[].payments.data[].idstringrequired

Example: "PPH25H07JYWLR7PA82"

data[].payments.data[].typestringrequired

Value"payment"

Example: "payment"

data[].payments.data[].amountintegerrequired

Example: 1000

data[].payments.data[].descriptionstringrequired

Example: "Test Payment"

data[].payments.data[].currencystringrequired

Value"EUR"

Example: "EUR"

data[].payments.data[].pay_methodpay_method (object) or null_type (any)required

Example: {"id":"ideal","type":"pay_method","name":"iDEAL","currencies":["EUR"],"minimum_amount":10,"maximum_amount":5000000,"details":{"issuers":[{"code":"ABNANL2A","name":"ABN AMRO"}]}}

Any of:

data[].payments.data[].pay_method.idstringrequired

Example: "ideal"

data[].payments.data[].pay_method.typestringrequired

Value"pay_method"

Example: "pay_method"

data[].payments.data[].pay_method.namestringrequired

Example: "iDEAL"

data[].payments.data[].pay_method.currenciesArray of strings

Items Value"EUR"

Example: ["EUR"]

data[].payments.data[].pay_method.minimum_amountinteger

Example: 10

data[].payments.data[].pay_method.maximum_amountinteger

Example: 5000000

data[].payments.data[].pay_method.detailsobject

Example: {"issuers":[{"code":"ABNANL2A","name":"ABN AMRO"}]}

data[].payments.data[].statestringrequired

Example: "paid"

data[].payments.data[].refunded_amountintegerrequired

data[].payments.data[].return_urlstring or null(uri)required

Example: "https://example.com/thank-you"

data[].payments.data[].cancel_urlstring or null(uri)required

Example: "https://example.com/cancel"

data[].payments.data[].metadataobjectrequired

Example: {}

data[].payments.data[].customerstring or nullrequired

Example: "CU7JRN6W6K3DA9"

data[].payments.data[].mandatestring or nullrequired

Example: "MD6ULYXJ4HP9RJ"

data[].payments.data[].subscriptionstring or nullrequired

data[].payments.data[].installment_planstring or nullrequired

data[].payments.data[].localestring or nullrequired

Enum"de""en""fr""nl"

Example: "en"

data[].payments.data[].paid_atstring or null(date-time)required

Example: "2023-06-30T12:44:35Z"

data[].payments.data[].created_atstring or null(date-time)required

Example: "2023-06-30T12:40:10Z"

data[].payments.data[]._linksobjectrequired

Example: {"self":"https://api.paypro.nl/payments/PPH25H07JYWLR7PA82","customer":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9","mandate":"https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"}

data[].payments.data[]._links.selfstring(uri)required

Example: "https://api.paypro.nl/payments/PPH25H07JYWLR7PA82"

data[].payments.data[]._links.customerstring(uri)

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

data[].payments.data[]._links.mandatestring(uri)

Example: "https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"

data[].payments.data[]._links.subscriptionstring(uri)

data[].payments.data[]._links.installment_planstring(uri)

data[].payments.data[]._links.checkoutstring(uri)

data[].payments.countintegerrequired

Example: 1

data[].payments._linksobjectrequired

Example: {"self":"https://api.paypro.nl/subscription_periods/SPD344S1PDY8XX/payments"}

data[].payments._links.selfstring(uri)required

Example: "https://api.paypro.nl/subscription_periods/SPD344S1PDY8XX/payments"

data[].created_atstring(date-time)required

Example: "2023-06-30T12:40:10Z"

data[]._linksobjectrequired

Example: {"self":"https://api.paypro.nl/subscription_periods/SPD344S1PDY8XX","subscription":"https://api.paypro.nl/subscriptions/PSUJDW4VCMG9JS"}

data[]._links.selfstring(uri)required

Example: "https://api.paypro.nl/subscription_periods/SPD344S1PDY8XX"

data[]._links.subscriptionstring(uri)required

Example: "https://api.paypro.nl/subscriptions/PSUJDW4VCMG9JS"

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"
  }
}

Subscription periods

Operations

Installment plans

Operations

Installment plan periods

Operations

Events

Operations

Webhooks

Operations

PayPro API Reference (v1)

Payments

Refunds

Chargebacks

Pay methods

Customers

Mandates

Subscriptions

Pauses a subscription

Request

Responses

Was this helpful?

Resumes a paused subscription

Request

Responses

Was this helpful?

Retrieves a list subscription periods that belong to this subscription

Request

Responses

Was this helpful?

Subscription periods

Installment plans

Installment plan periods

Events

Webhooks