Billink

Introduction

Billink Status

Billink Changelog

Release v2026.2 - 4 March, 2026

Release v2026.1 – January 20, 2026

Release 66 - November 11, 2025

Release 64 – October 7, 2025

Release 62 – August 26, 2025

Partners Exclusive

Merchant Create

Authorize payment

You can integrate Billink with or without a midpage. To integrate Billink with a midpage, you need to follow these steps.

Create Session

The Status API can be used to check whether an order has been paid or not. This API is optional.

Session Status

Order management

The Start Workflow API can initiate orders as soon as they are delivered. By default, an automatic start delay of 3 days is set. If you wish to use this API, you need to extend the start delay. This can easily be adjusted by yourself at app.billink.nl/settings behind the workflow.

Attention!
This API can be used 1 minute after the order is shot.

Start Workflow

With the Credit API, a product or amount can be credited on the invoice. This API is optional.

Credit

Create Tracker

Update Tracker

With the Payment API, a payment can be booked on the invoice. This API can be useful if consumers regularly transfer amounts to the webshop. This API is optional.

Payment

The On Hold API allows invoices to be put on hold for two weeks. This API is optional.

On Hold

The Resume API allows invoices to be resumed from hold. This API is optional.

Resume Order

With the Order Info API, it can be requested whether an order has been paid or not and in which step the order is located. This API is optional.

Order Info

With the Message API, messages can be posted on an order. These messages can be found in the backend of Billink by our customer service. This API is optional.

Message

Dispute

Dispute Categories

Dispute Create

Reconciliation

Invoices

Invoice Download

Webhooks

Generate Signing Secret

Order Webhook

Session Webhook

Errors

Brand assets

Billink brand assets

Payment badges

Logo lockups

Color codes

Implementation tips

Billink in your checkout

Need a different format?

Additional info

Contact information

Default

Billink Documentation

2026.2-1

Sandbox

Production

Disable Order Webhook

Disable Session Webhook

Set Order Webhook URL

Set Session Webhook URL

<p class="slate-p " >In <strong class="slate-bold">Billink API</strong>, error responses follow a consistent format. All errors are returned with an <strong class="slate-bold">HTTP</strong> status code <span style="color:#00FF00">200</span>, which indicates the request was processed but there was an issue with the operation. </p><p class="slate-p " >The format of the error is as follows:</p><div class="code-block-wrapper"  style="width:100%;min-width:100%" ><div class="code-block-header">JSON</div><pre class="slate-CodeBlockElement slate-code_block"><textarea id="publishedPageCodeblock" style="display:none !important; visibility: hidden; opacity: 0; width: 1px; height: 1px;" type="hidden"> </textarea><code class="language-json keep-markup drop-tokens"><div class="slate-code_line"><div class="slate-code_line">{
  &quot;code&quot;: &quot;000&quot;,
  &quot;description&quot;: &quot;Error message&quot;,
  &quot;result&quot;: &quot;error&quot;
}</div></div></code></pre></div><p class="slate-p " ></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Code</strong>: A unique error code representing the specific issue.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Description:</strong> A detailed description of the error.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Result: </strong>Short informative status</div></li></ul><p class="slate-p " >These errors might indicate a variety of issues including but not limited to problems with API versioning, client authentication, missing or incorrect parameters, data format issues, and restrictions on actions (such as workflow limitations or invalid operations).</p><h3 class="slate-h3 " >Common Issues:</h3><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Client Identification</strong>: Errors related to missing or incorrect client username, client id, or API version.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Invoice and Workflow Management</strong>: Missing or incorrect invoice numbers or workflow data.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Order Management</strong>: Trying to perform actions on orders that are not allowed or are already processed.</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Request Limitations</strong>: Exceeding request limits (e.g., number of invoices, action frequency).</div></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Parameter Validation</strong>: Incorrect or unsupported parameters in requests.</div></li></ol><p class="slate-p " >This helps you to easily handle and debug issues by following the provided error code descriptions across all API endpoints.</p><p class="slate-p " >In the next subsections, you will see errors specific to each endpoint. Each of these subsections includes a list of error codes and their corresponding descriptions to help you understand and resolve issues effectively.</p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p>

, error responses follow a consistent format. All errors are returned with an 

, which indicates the request was processed but there was an issue with the operation. 

These errors might indicate a variety of issues including but not limited to problems with API versioning, client authentication, missing or incorrect parameters, data format issues, and restrictions on actions (such as workflow limitations or invalid operations).

This helps you to easily handle and debug issues by following the provided error code descriptions across all API endpoints.

In the next subsections, you will see errors specific to each endpoint. Each of these subsections includes a list of error codes and their corresponding descriptions to help you understand and resolve issues effectively.

<h3 class="slate-h3 " >Summary of Create Session Error Codes</h3><p class="slate-p " >The Create Session error codes mainly cover validation issues with client data, access permissions, and general server errors.</p><p class="slate-p " >Common problems include:</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Missing required client fields such as billinkUsername, billinkID, and workflowNumber.</div></li><li class="slate-li " ><div style="position:relative">Access denial due to insufficient permissions.</div></li><li class="slate-li " ><div style="position:relative">Client not found errors when billinkID or billinkUsername do not match any records.</div></li><li class="slate-li " ><div style="position:relative">Unexpected server errors causing failure during session creation.</div></li></ul><p class="slate-p " ></p><div class="published-table"><div class="table-container" style="padding-left: 0px;"><table class="slate-table" style="min-width:100%;"><div class="published-table-header" style="width:100%;min-width:100%;"><div style="width:459px;">Code</div><div style="width:initial;">Message</div></div><colgroup ><col style="width:459px"><col style="width:initial"></colgroup><tbody class="slate-TableElement-tbody"><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><h4 class="slate-h4 " >400</h4></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><h4 class="slate-h4 " >The form contains the following errors:  1) client.billinkUsername: This value should not be blank. 2) client.billinkID: This value should not be blank. 3) client.workflowNumber: This value should not be blank.</h4></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><h4 class="slate-h4 " >403</h4></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><h4 class="slate-h4 " >Access denied</h4></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><h4 class="slate-h4 " >404</h4></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><h4 class="slate-h4 " >No client found with such billinkID or billinkUsername</h4></td></div></tr><tr class="slate-tr " ><div class="slate-TableCellElement-content"><td class="slate-td"><h4 class="slate-h4 " >500</h4></td></div><div class="slate-TableCellElement-content"><td class="slate-td"><h4 class="slate-h4 " >Something went wrong</h4></td></div></tr></tbody></table></div></div><p class="slate-p " ></p><p class="slate-p " ></p>

The Create Session error codes mainly cover validation issues with client data, access permissions, and general server errors.

Sections

Create Session

Summary of Create Session Error Codes

400

The form contains the following errors: 1) client.billinkUsername: This value should not be blank. 2) client.billinkID: This value should not be blank. 3) client.workflowNumber: This value should not be blank.

403

Access denied

404

No client found with such billinkID or billinkUsername

500

Something went wrong

What made this section helpful for you?

What made this section unhelpful for you?

On this page