Paylinks

Create paylink

POST /paylink/v1/paylinks

Headers

Content-Type string
Content type.

Authorization string
Access token generated from create token request.

Attributes

payment_method array

Can be one or more of the following:

credit-card
direct-debit
open-banking

transaction_type string
Can be one of the following:

SALE
PREAUTH
VERIFY CARD

full_name string
Customer full name.

email string
Customer email.

mobile_number string
Customer mobile number.

transaction_unique string
Unique transaction string.

is_decide_amount boolean
If customer will decide amount:

true
false

amount float
Transaction amount.

reminder boolean optional
If reminder will be sent to customer:

true
false (default value)

reminder_interval_count integer optional
If reminder is true, then need to mention the number of days/weeks

reminder_interval_frequency string optional
If reminder is true, then need to mention the interval frequency. It can be one of the following:

days
week

notes string optional
Add any note to describe the Paylink request to the customer.

notification_url string
POST URL on your domain, where Blink will send status updates when the transaction status is changed e.g. https://mydomain.com/notification.

Request

POST https://secure.blinkpayment.co.uk/api/paylink/v1/paylinks HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbG...

{
    "payment_method": ["credit-card","open-banking"],
    "transaction_type": "SALE",
    "full_name": "Test Developer",
    "email": "testdeveloper@gmail.com",
    "mobile_number": "9123908567",
    "transaction_unique": "fyr7894",
    "is_decide_amount": true,
    "amount": 1.00,
    "reminder": true,
    "reminder_interval_count": 2,
    "reminder_interval_frequency": "days",
    "notes": "test note",
    "notification_url": "https://mydomain.com/notification"
}

Response

HTTP/1.1 201 Created
Content-Type: application/json

{
    "id": 123,
    "paylink_url": "https://secure.blinkpayment.co.uk/secondstore/l/5jkigj",
    "transaction_unique": "fyr7894"
}

Get paylinks

GET /paylink/v1/paylinks/{id}

Headers

Content-Type string
Content type.

Authorization string
Access token generated from create token request.

Attributes

id integer

Paylink id. If id is not present, then it will return all the Paylinks created by that merchant.

Request

GET https://secure.blinkpayment.co.uk/api/paylink/v1/paylink/123 HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbG...

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": 123,
    "status": "Unpaid",
    "created_by": "Test developer",
    "amount": 1.00,
    "currency": "GBP",
    "transaction_type": "SALE",
    "customer_name": "Demo Customer",
    "customer_email": "demo123@gmail.com",
    "phone_number": "2374993932",
    "payment_method": ["credt-card","open-banking"],
    "is_decide_amount": true,
    "notes": "test"
}

Update paylinks

PATCH /paylink/v1/paylinks/{id}

Update any data associated with the paylink until the link is used.

Headers

Content-Type string
Content type.

Authorization string
Access token generated from create token request.

Attributes

notification_url string (optional)
Notification url.

Request

PATCH https://secure.blinkpayment.co.uk/api/paylink/v1/paylinks/{id} HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbG...

{
  "notification_url": "https://mydomain.com/notification"
}

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": 123,
    "status": "Unpaid",
    "created_by": "Test developer",
    "amount": 1.00,
    "currency": "GBP",
    "transaction_type": "SALE",
    "customer_name": "Demo Customer",
    "customer_email": "demo123@gmail.com",
    "phone_number": "2374993932",
    "payment_method": ["credt-card","open-banking"],
    "is_decide_amount": true,
    "notes": "test"
}

Delete paylink

DELETE /paylink/v1/paylinks/{id}

Delete a specific paylink using it’s id.

Headers

Content-Type string
Content type.

Authorization string
Access token generated from create token request.

Request

DELETE https://secure.blinkpayment.co.uk/api/paylink/v1/paylinks/{id} HTTP/1.1
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbG...

Response

HTTP/1.1 204 No Content

Notification webhook

POST https://<notification_url>

Headers

Content-Type string
Content type is JSON.

Attributes

transaction_id string
Transaction id.

status string
The new status of the transaction.

note string
Notification note.

Request

POST https://my_domain/notification HTTP/1.1
Content-Type: application/json

{
    "transaction_id": "BL-****",
    "status": "Paid",
    "note": "Payment successful"
}

Response

HTTP/1.1 200 OK