Payments

Tikkie

Enables Tikkie business customers to create payment requests.

New API! Read our blog.
Migrate if you use Tikkie Payment Request.

Technical Details

Open API Specification

  • To download the Tikkie OAS in YAML format, click here

  • To view the reference content and understand the full semantics of this service, open the .YAML file in a tool such as Swagger Editor.

POST Payment request

POST /v2/tikkie/paymentrequests

Creates a payment request. The application must have payment permission to complete this request. A payment request can one or more of the statuses listed below.

Payment status values
  • OPEN: A payment request is open and ready to be paid.
  • CLOSED: A payment request is closed.
  • EXPIRED: A payment request has expired.
    The default expiry period is 14 days. You can customize this when you start using the Payment Request API in production.
  • MAX_YIELD_REACHED: The payment request has reached its maximum amount in Euro. This limit is dependent on the agreed maximum amount.
  • MAX_SUCCESSFUL_PAYMENTS_REACHED: The payment request has reached its maximum amount of payments. The maximum amount of payments per request can be set to one or unlimited.
Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
description String Body true Description of the payment request which the payer or payers will see. Max length: 35 characters.
amountInCents Integer Body false Amount in cents of the payment request (euros). If this value is not specified an open payment request will be created.
expiryDate String Body false Date after which the payment request will expire and cannot be paid. Format is yyyy-mm-dd.
referenceId String Body false ID for the reference of the API consumer. Max length: 35 characters.
Sample Request
curl -X POST 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequests' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}' \
-H 'Content-Type: application/json' \
-d '{
    "description": "Description",
    "amountInCents": 20000,
    "expiryDate": "2020-07-15",
    "referenceId": "Reference"
}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
paymentRequestToken String Body true Unique token identifying this payment request which is later used when retrieving details.
amountInCents Integer Body false Amount in cents to be paid (euros). Value will not be present for open payment requests.
referenceId String Body false Unique ID reference for the API consumer.
description String Body true Description of the payment request which the payer or payers will see.
url String Body true URL where the payment request can be paid.
expiryDate String Body true Date after which the payment request will expire and cannot be paid. Format is yyyy-mm-dd.
createdDateTime String Body true Timestamp at which the payment request was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
status String Body true Current status of the payment request. Possible values are: 'OPEN', 'CLOSED', 'EXPIRED', 'MAX_YIELD_REACHED', and 'MAX_SUCCESSFUL_PAYMENTS_REACHED'
Sample Response
{
    "paymentRequestToken": "3YQfvTUrDPHq2aTc5cpA7C",
    "amountInCents": 20000,
    "referenceId": "Reference",
    "description": "Description",
    "url": "https://sbx.tikkie.me/pay/TSTsdSvockL/3YQfvTUrDPHq2aTc5cpA7C",
    "expiryDate": "2020-07-15",
    "createdDateTime": "2020-03-19T15:17:08.406Z",
    "status": "OPEN"
}

GET Payment request list

GET /v2/tikkie/paymentrequests

Displays a list of payment requests based on the parameters that are provided. The application must have payment permission to complete this request.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
pageNumber Integer Query true Number of the page to be returned. Starts at zero.
pageSize Integer Query true Number of items on a page. Range: 1-50
fromDateTime String Query false Point in time where to start searching for items. Format: YYYY-MM-DD:HH:mm:ss.SSSZ
toDateTime String Query false Point in time where to stop searching for items. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
Sample Request
curl -X GET 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequests?pageNumber=0&pageSize=10&fromDateTime=2020-01-01T00:00:00.000Z&toDateTime=2020-04-01T00:00:00.000Z' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
paymentRequests Array Body true Array containing all payment requests which match the specified criteria.
paymentRequests.paymentRequestToken String Body true Unique token identifying this payment request which is later used when retrieving details.
paymentRequests.amountInCents Integer Body false Amount in cents to be paid (euros). Value will not be present for open payment requests.
paymentRequests.referenceId String Body false ID for the reference of the API consumer.
paymentRequests.description String Body true Description of the payment request which the payer or payers will see.
paymentRequests.url String Body true URL where the payment request can be paid.
paymentRequests.expiryDate String Body true Date after which the payment request will expire and cannot be paid. Format is yyyy-mm-dd.
paymentRequests.createdDateTime String Body true Timestamp at which the payment request was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
paymentRequests.status String Body true Current status of the payment request. Possible values are: 'OPEN', 'CLOSED', 'EXPIRED', 'MAX_YIELD_REACHED', and 'MAX_SUCCESSFUL_PAYMENTS_REACHED'
paymentRequests.numberOfPayments Integer Body true Number of payments which have been collected on this payment request.
paymentRequests.totalAmountPaidInCents Integer Body true Total amount in cents which has been collected on this payment request
totalElementCount Integer Body true Total amount of payment requests which match the search parameters provided.
Sample Response
{
    "paymentRequests": [
        {
            "paymentRequestToken": "2bF28uuy7RuSzqTv3b3yHX",
            "description": "Description",
            "url": "https://sbx.tikkie.me/pay/TSTsdSvockL/2bF28uuy7RuSzqTv3b3yHX",
            "expiryDate": "2020-07-15",
            "createdDateTime": "2020-03-19T15:28:29.078Z",
            "status": "OPEN",
            "numberOfPayments": 0,
            "totalAmountPaidInCents": 0
        },
        ...
        {
            "paymentRequestToken": "2SgHH3xHgfKbAgBjd5nMP1",
            "amountInCents": 20000,
            "referenceId": "Reference",
            "description": "Description",
            "url": "https://sbx.tikkie.me/pay/TSTsdSvockL/2SgHH3xHgfKbAgBjd5nMP1",
            "expiryDate": "2020-07-15",
            "createdDateTime": "2020-03-19T15:16:53.546Z",
            "status": "OPEN",
            "numberOfPayments": 0,
            "totalAmountPaidInCents": 0
        }
    ],
    "totalElementCount": "87"
}

GET Payment request

GET /v2/tikkie/paymentrequests/{paymentRequestToken}

Retrieves a specific payment request based on a token value. The application must have payment permission to complete this request.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
paymentRequestToken String Path true Token identifying the payment request.
Sample Request
curl -X GET 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequests/{your_payment_request_token}' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
paymentRequestToken String Body true Unique token identifying this payment request which is later used when retrieving details.
amountInCents Integer Body false Amount in cents to be paid (euros). Value will not be present for open payment requests.
referenceId String Body false ID for the reference of the API consumer.
description String Body true Description of the payment request which the payer or payers will see.
url String Body true URL where the payment request can be paid.
expiryDate String Body true Date after which the payment request will expire and cannot be paid. Format is yyyy-mm-dd.
createdDateTime String Body true Timestamp at which the payment request was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
status String Body true Current status of the payment request. Possible values are: 'OPEN', 'CLOSED', 'EXPIRED', 'MAX_YIELD_REACHED', and 'MAX_SUCCESSFUL_PAYMENTS_REACHED'
numberOfPayments Integer Body true Number of payments which have been collected on this payment request.
totalAmountPaidInCents Integer Body true Total amount in cents which has been collected on this payment request
Sample Response
{
    "paymentRequestToken": "2SgHH3xHgfKbAgBjd5nMP1",
    "amountInCents": 20000,
    "referenceId": "Reference",
    "description": "Description",
    "url": "https://sbx.tikkie.me/pay/TSTsdSvockL/2SgHH3xHgfKbAgBjd5nMP1",
    "expiryDate": "2020-07-15",
    "createdDateTime": "2020-03-19T15:16:53.546Z",
    "status": "OPEN",
    "numberOfPayments": 2,
    "totalAmountPaidInCents": 40000
}

GET Payment list

GET /v2/tikkie/paymentrequests/{paymentRequestToken}/payments

Displays a list of payments based on the parameters that are provided. The application must have payment permission to complete this request.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
paymentRequestToken String Path true Token identifying the payment request.
pageNumber Integer Query true Number of the page to be returned. Starts at zero.
pageSize Integer Query true Number of items on a page. Range: 1-50
fromDateTime String Query false Point in time to start searching for items. Format: YYYY-MM-DD:HH:mm:ss.SSSZ
toDateTime String Query false Point in time to stop searching for items. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
includeRefunds Boolean Query false Include refunds in the response.
Sample Request
curl -X GET 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequests/{your_payment_request_token}/payments?pageNumber=0&pageSize=10&fromDateTime=2020-01-01T00:00:00.000Z&toDateTime=2020-04-01T00:00:00.000Z&includeRefunds=true' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
totalElementCount Integer Body true Total amount of payments which match the search parameters provided.
payments Array Body true Array containing all payments which match the specified criteria.
payments.paymentToken String Body true Unique token identifying this payment.
payments.tikkieId String Body true Unique ID identifying this payment. This will be displayed on the payers statement.
payments.counterPartyName String Body true Name of the payer.
payments.counterPartyAccountNumber String Body true IBAN of the payer.
payments.amountInCents Integer Body false Amount in cents which was paid (euros).
payments.description String Body true Description of the payment request which the payer or payers will see.
payments.createdDateTime String Body true Timestamp at which the payment request was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
payments.refunds Array Body true Array containing all refunds on this payment.
payments.refunds.refundToken String Body true Unique token identifying this refund.
payments.refunds.amountInCents Integer Body true Amount of the refund in cents (euros).
payments.refunds.description String Body true Description of the refund.
payments.refunds.referenceId String Body false Unique ID reference for the API consumer.
payments.refunds.createdDateTime String Body true Timestamp at which the refund was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
payments.refunds.status String Body true Current status of the refund. Possible values are: 'PENDING', 'PAID'
Sample Response
{
    "totalElementCount": 2,
    "payments": [
        {
            "paymentToken": "36160db6-9d80-487c-9fff-75b91250b259",
            "tikkieId": 100023102,
            "counterPartyName": "E. Xample",
            "counterPartyAccountNumber": "NL01ABNA1234567890",
            "amountInCents": 20000,
            "description": "Description",
            "createdDateTime": "2020-03-19T17:16:09.695",
            "refunds": [
                {
                    "refundToken": "f11fSN8NXANAjiXSiMD5xb",
                    "amountInCents": 10000,
                    "description": "Refund",
                    "referenceId": "Reference",
                    "createdDateTime": "2020-03-19T17:28:11.698",
                    "status": "PAID"
                }
            ]
        },
        {
            "paymentToken": "a4acba44-8e4b-49cd-9ded-5109c7c37d43",
            "tikkieId": 100023101,
            "counterPartyName": "E. Xample",
            "counterPartyAccountNumber": "NL01ABNA1234567890",
            "amountInCents": 20000,
            "description": "Description",
            "createdDateTime": "2020-03-19T17:15:59.572",
            "refunds": []
        }
    ]
}

GET Payment

GET /v2/tikkie/paymentrequests/{paymentRequestToken}/payments/{paymentToken}

Retrieves the details of a specific payment based on a token value. The application must have payment permission to complete this request.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
paymentRequestToken String Path true Token identifying the payment request.
paymentToken String Path true Token identifying the payment.
Sample Request
curl -X GET 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequests/{your_payment_request_token}/payments/{your_payment_token}' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
paymentToken String Body true Unique token identifying this payment.
tikkieId String Body true Unique ID identifying this payment. This will be displayed on the payers statement.
counterPartyName String Body true Name of the payer.
counterPartyAccountNumber String Body true IBAN of the payer.
amountInCents Integer Body false Amount in cents which was paid (euros).
description String Body true Description of the payment request which the payer or payers will see.
createdDateTime String Body true Timestamp at which the payment request was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
refunds Array Body true Array containing all refunds on this payment.
refunds.refundToken String Body true Unique token identifying this refund.
refunds.amountInCents Integer Body true Amount of the refund in cents (euros).
refunds.description String Body true Description of the refund.
refunds.referenceId String Body false Unique ID reference for the API consumer.
refunds.createdDateTime String Body true Timestamp at which the refund was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
refunds.status String Body true Current status of the refund. Possible values are: 'PENDING', 'PAID'
Sample Response
{
    "paymentToken": "36160db6-9d80-487c-9fff-75b91250b259",
    "tikkieId": 100023102,
    "counterPartyName": "J. De Vos",
    "counterPartyAccountNumber": "NL04ABNA0547177100",
    "amountInCents": 20000,
    "description": "Description",
    "createdDateTime": "2020-03-19T17:16:09.695",
    "refunds": [
        {
            "refundToken": "f11fSN8NXANAjiXSiMD5xb",
            "amountInCents": 10000,
            "description": "Refund",
            "referenceId": "Reference",
            "createdDateTime": "2020-03-19T17:28:11.698",
            "status": "PAID"
        }
    ]
}

POST Refund

POST /v2/tikkie/paymentrequests/{paymentRequestToken}/payments/{paymentToken}/refunds

Creates a refund for a specific payment. The maximum amount which can be refunded for a payment is the amount paid plus €25.00. The application must have payment permission and refund permission to complete this request. A refund can one or more statuses, these statuses are described below.

Refund status values
  • PENDING: The refund has been scheduled and will be completed as soon as there is enough money in the account. If there is not enough money in the account on a particular day, the refund will be carried over to the next day and completed when the amount is available. The refund will remain in a scheduled state indefinitely until the amount is available and the refund is executed.
  • PAID: The refund has been paid out.
Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
paymentRequestToken String Path true Token identifying the payment request.
paymentToken String Path true Token identifying the payment.
description String Body true Description of the refund. Max length: 35 characters.
amountInCents Integer Body true Amount to refund in cents (euros).
referenceId String Body false Unique ID reference for the API consumer. Max length: 35 characters.
Sample Request
curl -X POST 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequests/{your_payment_request_token}/payments/{your_payment_token}/refunds' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}' \
-H 'Content-Type: application/json' \
-d '{
    "description": "Refund",
    "amountInCents": 5000,
    "referenceId": "Reference"
}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
refundToken String Body true Unique token identifying this refund.
amountInCents Integer Body true Amount of the refund in cents (euros).
description String Body true Description of the refund.
referenceId String Body false Unique ID reference for the API consumer.
createdDateTime String Body true Timestamp at which the refund was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
status String Body true Current status of the refund. Possible values are: 'PENDING', 'PAID'
Sample Response
{
    "refundToken": "7HpyvqGKRGAEE1gET4NS45",
    "amountInCents": 5000,
    "description": "Refund",
    "referenceId": "Reference",
    "createdDateTime": "2020-03-19T18:04:15.057",
    "status": "PENDING"
}

GET Refund

GET /v2/tikkie/paymentrequests/{paymentRequestToken}/payments/{paymentToken}/refunds/{refundToken}

Retrieves details of a specific refund based on a token value. The application must have payment permission to complete this request.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
paymentRequestToken String Path true Token identifying the payment request.
paymentToken String Path true Token identifying the payment.
refundToken String Path true Token identifying the refund.
Sample Request
curl -X GET 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequests/{your_payment_request_token}/payments/{your_payment_token}/refunds/{your_refund_token}' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
refundToken String Body true Unique token identifying this refund.
amountInCents Integer Body true Amount of the refund in cents (euros).
description String Body true Description of the refund.
referenceId String Body false ID for the reference of the API consumer.
createdDateTime String Body true Timestamp at which the refund was created. Format: YYYY-MM-DD:HH:mm:ss.SSSZ.
status String Body true Current status of the refund. Possible values are: 'PENDING', 'PAID'
Sample Response
{
    "refundToken": "7HpyvqGKRGAEE1gET4NS45",
    "amountInCents": 5000,
    "description": "Refund",
    "referenceId": "Reference",
    "createdDateTime": "2020-03-19T18:04:15.057",
    "status": "PAID"
}

POST Payment request subscription

POST /v2/tikkie/paymentrequestssubscription

Creates a payment request. The application must have payment permission to complete this request.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
url String Body true URL where the payment request can be paid.
Sample Request
curl -X POST 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequestssubscription' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}' \
-H 'Content-Type: application/json' \
-d '{
    "url": "https://www.example.com/paymentrequestnotification"
}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
subscriptionId String Body true Unique identifier for a subscription. This will be sent with the user's payment request notification.
Sample Response
{
    "subscriptionId": "fabe4644-7285-5340-873a-d3d25fe9c72a"
}
Notifications

There are two types of notifications: when a payment is paid on a payment request, and when a scheduled refund is paid out. In both scenarios, the recipient acknowledges the notification with a 2XX status. If a notification is not acknowledged, two additional attempts are made to deliver the notification.

Payment Notification Attributes
Name Type In Required Description
subscriptionId String Body true Unique ID that identifies a subscription that has sent a notification.
notificationType String Body true Type of notification. Possible values are: 'PAYMENT', 'REFUND'
paymentRequestToken String Body true Unique token identifying the payment request.
paymentToken String Body true Unique token identifying the payment.
Sample Payment Notificattion
{
  "subscriptionId":"fabe4644-7285-5340-873a-d3d25fe9c72a",
  "notificationType":"PAYMENT",
  "paymentRequestToken":"2SgHH3xHgfKbAgBjd5nMP1",
  "paymentToken":"64fda4cb-03b9-4198-a7fa-70c0553b7b5e"
}
Refund Notification Attributes
Name Type In Required Description
subscriptionId String Body true Unique ID that identifies a subscription that has sent a notification.
notificationType String Body true Type of notification. Possible values are: 'PAYMENT', 'REFUND'
paymentRequestToken String Body true Unique token identifying the payment request.
paymentToken String Body true Unique token identifying the payment.
refundToken String Body true Unique token identifying the refund.
Sample Refund Notificattion
{
  "subscriptionId":"fabe4644-7285-5340-873a-d3d25fe9c72a",
  "notificationType":"REFUND",
  "paymentRequestToken":"2SgHH3xHgfKbAgBjd5nMP1",
  "paymentToken":"36160db6-9d80-487c-9fff-75b91250b259",
  "refundToken":"j5EAEFr6e5rFYHtB9Ta8bc"
}

DELETE Payment request subscription

DELETE /v2/tikkie/paymentrequestssubscription

Deletes a subscription. The application must have payment permission to complete this request.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
Sample Request
curl -X DELETE 'https://api-sandbox.abnamro.com/v2/tikkie/paymentrequestssubscription' \
-H 'API-Key: {your_api_key}' \
-H 'X-App-Token: {your_app_token}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
Sample Response

The call will return a status code '204 No Content'.

POST Sandbox app

POST /v2/tikkie/sandboxapps

Important: This operation does not work in the production environment.

Creates an app in the sandbox for you to use with this API.

Request Attributes
Name Type In Required Description
API-Key String Header true Consumer key which is obtained after app registration on the ABN developer portal.
X-App-Token String Header true appToken generated in the Tikkie Business Portal.
Sample Request
curl -X POST 'https://api-sandbox.abnamro.com/v2/tikkie/sandboxapps' \
-H 'API-Key: {your_api_key}'
Response Attributes
Name Type In Required Description
Trace-Id String Header true A unique identifier for the request.
appToken String Body true appToken to use in other requests.
Sample Response
{
    "appToken": "1227d71a-27a4-42c2-a47f-f326b38cfca2"
}

Error Response & Codes

This section describes the error response and codes that are sent by the Tikkie API.

Sample Error Response
{
    "errors": [
        {
            "code": "DESCRIPTION_MISSING",
            "message": "description was not supplied in the request.",
            "reference": "https://developer.abnamro.com/api/tikkie-v2/operations",
            "traceId": "a81d67fe-cf9d-4a7c-8cce-e25c6a7c814c",
            "status": 400
        }
    ]
}
Error Attributes

This section lists the errors that are specific to this API. If your error is not listed here, or to see general errors that can occur, see Error codes.

Code Status Category Description
AMOUNT_IN_CENTS_MISSING 400 BAD_REQUEST amountInCents was not supplied in the request.
AMOUNT_IN_CENTS_INVALID 400 BAD_REQUEST The amountInCents is in an invalid format.
DESCRIPTION_MAX_LENGTH_EXCEEDED 400 BAD_REQUEST The description is too long.
DESCRIPTION_MISSING 400 BAD_REQUEST description was not supplied in the request.
EXPIRY_DATE_INVALID 400 BAD_REQUEST The expiryDate is in an invalid format.
EXPIRY_DATE_NOT_ALLOWED 400 BAD_REQUEST The expiryDate is invalid. This date has already passed.
FROM_DATE_TIME_INVALID 400 BAD_REQUEST fromDateTime is in an invalid format.
PAGE_NUMBER_MISSING 400 BAD_REQUEST pageNumber was not supplied in the query.
PAGE_SIZE_MISSING 400 BAD_REQUEST pageSize was not supplied in the query.
PAYMENT_REQUEST_MAX_AMOUNT_EXCEEDED 400 BAD_REQUEST The amountInCents is above the permitted threshold for this organization.
PAYMENT_REQUEST_TOKEN_INVALID 400 BAD_REQUEST paymentRequestToken is in an invalid format.
PAYMENT_TOKEN_INVALID 400 BAD_REQUEST paymentToken is in an invalid format.
REFERENCE_ID_INVALID 400 BAD_REQUEST The referenceId is in an invalid format.
REFUND_AMOUNT_IS_TOO_HIGH 400 BAD_REQUEST The total refund amount is larger than the payment plus €25.00.
REFUND_TOKEN_INVALID 400 BAD_REQUEST refundToken is in an invalid format.
TO_DATE_TIME_INVALID 400 BAD_REQUEST toDateTime is in an invalid format.
URL_DISALLOWED 400 BAD_REQUEST It is prohibited to use this URL for webhooks.
URL_INVALID 400 BAD_REQUEST URL is in an invalid format.
URL_MISSING 400 BAD_REQUEST URL was not supplied in the request.
APP_TOKEN_INVALID 401 UNAUTHORIZED Invalid appToken format.
APP_TOKEN_ALREADY_IN_USE 401 UNAUTHORIZED This appToken has already been used with another API Key.
APP_TOKEN_DISABLED 401 UNAUTHORIZED appToken disabled.
PAYMENT_REQUEST_FORBIDDEN 403 FORBIDDEN appToken does not have permission to create or get payment requests.
REFUND_FORBIDDEN 403 FORBIDDEN appToken does not have permission to create refunds.
BUNDLED_PAYOUT_NOT_ENABLED 403 FORBIDDEN This organization does not have bundled payout enabled, which is a prerequisite to create a refund. To enable bundled payout, contact Tikkie Business Support.
PAYMENT_REQUEST_NOT_FOUND 404 NOT_FOUND No payment request was found for the specified paymentRequestToken.
PAYMENT_NOT_FOUND 404 NOT_FOUND No payment was found for the specified paymentToken.
REFUND_NOT_FOUND 404 NOT_FOUND No refund was found for the specified refundToken.
INTERNAL_SERVER_ERROR 500 INTERNAL_SERVER_ERROR An unknown error occurred.