PayPro API Reference (v1)

Servers
https://api.paypro.nl/

Payments

Operations

Refunds

Operations

Retrieves a refund

Request

Retrieves a single refund based on the id.

Path
idstringrequired

Responses

refund found

Bodyapplication/json
idstringrequired
Example: "PRRNQH3PCD125Z"
typestringrequired
Value"refund"
Example: "refund"
amountintegerrequired
Example: 1000
descriptionstringrequired
Example: "Test Payment"
reasonstring or nullrequired
currencystringrequired
Value"EUR"
Example: "EUR"
paymentstringrequired
Example: "PPBLGEE6UG92MS"
statestringrequired
Example: "refunded"
refunded_atstring or null(date-time)required
Example: "2023-06-30T12:44:35Z"
created_atstring(date-time)required
Example: "2023-06-30T12:40:10Z"
_linksobjectrequired
Example: {"self":"https://api.paypro.nl/refunds/PRRNQH3PCD125Z","payment":"https://api.paypro.nl/payments/PPBLGEE6UG92MS"}
_links.​selfstring(uri)required
Example: "https://api.paypro.nl/refunds/PRRNQH3PCD125Z"
_links.​paymentstring(uri)required
Example: "https://api.paypro.nl/payments/PPBLGEE6UG92MS"
Response
application/json
{
  "id": "PRRNQH3PCD125Z",
  "type": "refund",
  "amount": 1000,
  "description": "Test Payment",
  "reason": "",
  "payment": "PPBLGEE6UG92MS",
  "currency": "EUR",
  "state": "refunded",
  "refunded_at": "2023-06-30T12:44:35Z",
  "created_at": "2023-06-30T12:40:10Z",
  "_links": {
    "self": "https://api.paypro.nl/refunds/PRRNQH3PCD125Z",
    "payment": "https://api.paypro.nl/payments/PPBLGEE6UG92MS"
  }
}

Cancels a refund

Request

Cancels a refund. It is possible to cancel refund only in open, pending or processing state.

Path
idstringrequired

Responses

refund canceled

Bodyapplication/json
idstringrequired
Example: "PRRNQH3PCD125Z"
typestringrequired
Value"refund"
Example: "refund"
amountintegerrequired
Example: 1000
descriptionstringrequired
Example: "Test Payment"
reasonstring or nullrequired
currencystringrequired
Value"EUR"
Example: "EUR"
paymentstringrequired
Example: "PPBLGEE6UG92MS"
statestringrequired
Example: "refunded"
refunded_atstring or null(date-time)required
Example: "2023-06-30T12:44:35Z"
created_atstring(date-time)required
Example: "2023-06-30T12:40:10Z"
_linksobjectrequired
Example: {"self":"https://api.paypro.nl/refunds/PRRNQH3PCD125Z","payment":"https://api.paypro.nl/payments/PPBLGEE6UG92MS"}
_links.​selfstring(uri)required
Example: "https://api.paypro.nl/refunds/PRRNQH3PCD125Z"
_links.​paymentstring(uri)required
Example: "https://api.paypro.nl/payments/PPBLGEE6UG92MS"
Response
application/json
{
  "id": "PRRNQH3PCD125Z",
  "type": "refund",
  "amount": 1000,
  "description": "Test Payment",
  "reason": "",
  "payment": "PPBLGEE6UG92MS",
  "currency": "EUR",
  "state": "refunded",
  "refunded_at": "2023-06-30T12:44:35Z",
  "created_at": "2023-06-30T12:40:10Z",
  "_links": {
    "self": "https://api.paypro.nl/refunds/PRRNQH3PCD125Z",
    "payment": "https://api.paypro.nl/payments/PPBLGEE6UG92MS"
  }
}

Retrieve a list of refunds

Request

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

Responses

refunds found

Bodyapplication/json
typestringrequired
Value"list"
dataArray of objects(refund)required
Example: [{"id":"PRRNQH3PCD125Z","type":"refund","amount":1000,"description":"Test Payment","reason":"","payment":"PPBLGEE6UG92MS","currency":"EUR","state":"refunded","refunded_at":"2023-06-30T12:44:35Z","created_at":"2023-06-30T12:40:10Z","_links":{"self":"https://api.paypro.nl/refunds/PRRNQH3PCD125Z","payment":"https://api.paypro.nl/payments/PPBLGEE6UG92MS"}}]
data[].​idstringrequired
Example: "PRRNQH3PCD125Z"
data[].​typestringrequired
Value"refund"
Example: "refund"
data[].​amountintegerrequired
Example: 1000
data[].​descriptionstringrequired
Example: "Test Payment"
data[].​reasonstring or nullrequired
data[].​currencystringrequired
Value"EUR"
Example: "EUR"
data[].​paymentstringrequired
Example: "PPBLGEE6UG92MS"
data[].​statestringrequired
Example: "refunded"
data[].​refunded_atstring or null(date-time)required
Example: "2023-06-30T12:44:35Z"
data[].​created_atstring(date-time)required
Example: "2023-06-30T12:40:10Z"
data[].​_linksobjectrequired
Example: {"self":"https://api.paypro.nl/refunds/PRRNQH3PCD125Z","payment":"https://api.paypro.nl/payments/PPBLGEE6UG92MS"}
data[].​_links.​selfstring(uri)required
Example: "https://api.paypro.nl/refunds/PRRNQH3PCD125Z"
data[].​_links.​paymentstring(uri)required
Example: "https://api.paypro.nl/payments/PPBLGEE6UG92MS"
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"
  }
}

Chargebacks

Operations

Pay methods

Operations

Customers

Operations

Mandates

Operations

Subscriptions

Operations

Subscription periods

Operations

Installment plans

Operations

Installment plan periods

Operations

Events

Operations

Webhooks

Operations