Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Getting started

Welcome to our collection of Blink API Integration Guides.


Anchor
get-api-keys
get-api-keys

Get API Keys

Before using, you will need to login log in to Blink and get the API key and secret key for your Blink page:

1.1 Open Log in to https://secure.blinkpayment.co.uk

1.2 Scroll down to API Credentials on your dashboardNavigate to My Blink pages under Customer Centre.

1.3 Select the relevant Blink pagePage

1.4 You should see the API key and secret key for the selected page.

If you have a test developer account, you can also find the API Credentials on your dashboard.

NOTE: If you do not see the keys, then please contact the Blink support team to set up the API keys for you.

Image RemovedImage Added

Anchor
endpoints
endpoints

Endpoints

Method

Endpoint

Description

POST 

pay/v1/tokens

Create an access token 

POST 

pay/v1/intents

Create an intent 

GET 

pay/v1/intents/{id} 

Return the intent 

PATCH 

pay/v1/intents/{id} 

Update the intent 

POST 

pay/v1/elements

Return required details to populate payment form 

POST 

pay/v1/creditcards

Processes credit card payment and redirects to return_url 

GET

pay/v1/transactions/{id}

Returns transactions details

POST

{notification_url}

Redirects

500  

Something went wrong 

Pushback transaction details to the specified notification URL

POST 

pay/v1/directdebits

Create customer, their bank account, mandate and payment request using the customer details and returns to user defined return URL after successful payment request creation 

POST 

pay/v1/openbankings

Process open banking request with transaction details. On success, it will provide the bank server redirect URL. 

AnchorerrorserrorsErrors

Name

Description

200 OK 

 Everything worked as expected.

400 Bad Request 

Often due to missing a required parameter.

401 Unauthorized 

No valid API key provided.

402 Request failed

The parameters were valid but the request failed.

403 Forbidden 

The API key doesn't have permissions to perform the request.

404 Not Found 

The requested resource doesn't exist. 

409 - Conflict

Conflicts with another request (perhaps using the same key).

429 - Too Many Requests

Too many requests hit the API too quickly.

POST

pay/v1/transactions/{id}/reruns

Rerun any existing transaction which has been failed earlier.

POST

pay/v1/transactions/{id}/captures

Capture any transaction earlier than the predefined delay capture duration

POST

paylink/v1/paylinks

Create paylink url

GET

paylink/v1/paylinks/{id}

Return the paylink details. If, Id is not passed, it will return all the paylinks created from that merchant account.

PATCH

paylink/v1/paylinks/{id}

Update the paylink

DELETE

paylink/v1/paylinks/{id}

Delete the paylink

POST

paylink/v1/paylinks/{id}/notifications

Send reminder to the email or phone number at any time for the payment of the paylink



Anchor
markup-conventions
markup-conventions

Markup Conventions

Item

Description

Auth

Code in the body of test

Code Block
POST ...

Code block

{{access_token}}

Variable in code

GET

Get method

POST

Post method

PUT

Put method

PATCH

Patch method

DELETE

Delete method

(optional)

All attributes are mandatory, unless identified optional keyword.