PayPro API Reference (v1)

Servers

https://api.paypro.nl/

Payments

Operations

Refunds

Operations

Chargebacks

Operations

Pay methods

Operations

Customers

Operations

Mandates

Operations

Subscriptions

Operations

Subscription periods

Operations

Installment plans

Operations

Installment plan periods

Operations

Retrieves a installment plan period

Request

Retrieves a single installment plan period based on the id.

Path

idstringrequired

Responses

installment plan period found

Bodyapplication/json

idstringrequired

Example: "IPD344S1PDY8XX"

typestringrequired

Value"installment_plan_period"

Example: "installment_plan_period"

amountintegerrequired

Example: 1500

period_numberintegerrequired

Example: 1

installment_planstringrequired

Example: "PIUJDW4VCMG9JS"

statestringrequired

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

Example: "paid"

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/installment_plan_periods/SPD344S1PDY8XX/payments"}}

payments.typestringrequired

Value"list"

Example: "list"

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

payments.data[].idstringrequired

Example: "PPH25H07JYWLR7PA82"

payments.data[].typestringrequired

Value"payment"

Example: "payment"

payments.data[].amountintegerrequired

Example: 1000

payments.data[].descriptionstringrequired

Example: "Test Payment"

payments.data[].currencystringrequired

Value"EUR"

Example: "EUR"

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:

payments.data[].pay_method.idstringrequired

Example: "ideal"

payments.data[].pay_method.typestringrequired

Value"pay_method"

Example: "pay_method"

payments.data[].pay_method.namestringrequired

Example: "iDEAL"

payments.data[].pay_method.currenciesArray of strings

Items Value"EUR"

Example: ["EUR"]

payments.data[].pay_method.minimum_amountinteger

Example: 10

payments.data[].pay_method.maximum_amountinteger

Example: 5000000

payments.data[].pay_method.detailsobject

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

payments.data[].statestringrequired

Example: "paid"

payments.data[].refunded_amountintegerrequired

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

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

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

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

payments.data[].metadataobjectrequired

Example: {}

payments.data[].customerstring or nullrequired

Example: "CU7JRN6W6K3DA9"

payments.data[].mandatestring or nullrequired

Example: "MD6ULYXJ4HP9RJ"

payments.data[].subscriptionstring or nullrequired

payments.data[].installment_planstring or nullrequired

payments.data[].localestring or nullrequired

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

Example: "en"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

payments.countintegerrequired

Example: 1

payments._linksobjectrequired

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

payments._links.selfstring(uri)required

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

created_atstring(date-time)required

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

_linksobjectrequired

Example: {"self":"https://api.paypro.nl/installment_plan_periods/IPD344S1PDY8XX","installment_plan":"https://api.paypro.nl/installment_plans/PIUJDW4VCMG9JS"}

_links.selfstring(uri)required

Example: "https://api.paypro.nl/installment_plan_periods/IPD344S1PDY8XX"

_links.installment_planstring(uri)required

Example: "https://api.paypro.nl/installment_plans/PIUJDW4VCMG9JS"

Response

application/json

{
  "id": "IPD344S1PDY8XX",
  "type": "installment_plan_period",
  "amount": 1500,
  "period_number": 1,
  "installment_plan": "PIUJDW4VCMG9JS",
  "state": "paid",
  "payments": {
    "type": "list",
    "data": [ … ],
    "count": 1,
    "_links": { … }
  },
  "created_at": "2023-06-30T12:40:10Z",
  "_links": {
    "self": "https://api.paypro.nl/installment_plan_periods/IPD344S1PDY8XX",
    "installment_plan": "https://api.paypro.nl/installment_plans/PIUJDW4VCMG9JS"
  }
}

Retrieves a list of payments that belong to this installment plan period

Request

Retrieves a list of payments that belong to this installment plan period.

Path

idstringrequired

Responses

payments found

Bodyapplication/json

typestringrequired

Value"list"

dataArray of objects(payment)required

Example: [{"id":"PPH25H07JYWLR7PA82","type":"payment","amount":1000,"description":"Test Payment","currency":"EUR","pay_method":{"id":"ideal","type":"pay_method","name":"iDEAL","currencies":["EUR"],"minimum_amount":10,"maximum_amount":5000000,"details":{"issuers":[{"code":"ABNANL2A","name":"ABN AMRO"}]}},"state":"paid","refunded_amount":0,"return_url":"https://example.com/thank-you","cancel_url":"https://example.com/cancel","metadata":{},"customer":"CU7JRN6W6K3DA9","mandate":"MD6ULYXJ4HP9RJ","subscription":null,"installment_plan":null,"locale":"en","paid_at":"2023-06-30T12:44:35Z","created_at":"2023-06-30T12:40:10Z","_links":{"self":"https://api.paypro.nl/payments/PPH25H07JYWLR7PA82","customer":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9","mandate":"https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"}}]

data[].idstringrequired

Example: "PPH25H07JYWLR7PA82"

data[].typestringrequired

Value"payment"

Example: "payment"

data[].amountintegerrequired

Example: 1000

data[].descriptionstringrequired

Example: "Test Payment"

data[].currencystringrequired

Value"EUR"

Example: "EUR"

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[].pay_method.idstringrequired

Example: "ideal"

data[].pay_method.typestringrequired

Value"pay_method"

Example: "pay_method"

data[].pay_method.namestringrequired

Example: "iDEAL"

data[].pay_method.currenciesArray of strings

Items Value"EUR"

Example: ["EUR"]

data[].pay_method.minimum_amountinteger

Example: 10

data[].pay_method.maximum_amountinteger

Example: 5000000

data[].pay_method.detailsobject

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

data[].statestringrequired

Example: "paid"

data[].refunded_amountintegerrequired

data[].return_urlstring or null(uri)required

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

data[].cancel_urlstring or null(uri)required

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

data[].metadataobjectrequired

Example: {}

data[].customerstring or nullrequired

Example: "CU7JRN6W6K3DA9"

data[].mandatestring or nullrequired

Example: "MD6ULYXJ4HP9RJ"

data[].subscriptionstring or nullrequired

data[].installment_planstring or nullrequired

data[].localestring or nullrequired

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

Example: "en"

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

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

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

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

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[]._links.selfstring(uri)required

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

data[]._links.customerstring(uri)

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

data[]._links.mandatestring(uri)

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

data[]._links.subscriptionstring(uri)

data[]._links.installment_planstring(uri)

data[]._links.checkoutstring(uri)

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

Events

Operations

Webhooks

Operations

PayPro API Reference (v1)

Payments

Refunds

Chargebacks

Pay methods

Customers

Mandates

Subscriptions

Subscription periods

Installment plans

Installment plan periods

Retrieves a installment plan period

Request

Responses

Was this helpful?

Retrieves a list of payments that belong to this installment plan period

Request

Responses

Was this helpful?

Events

Webhooks