Intents

Overview

The Intents API allows you to create and manage payment intents, which are used to initiate and track Blink transactions. These intents can be integrated into various payment flows, providing a flexible and secure way to handle payments.  


Intent Features  

Flexible Payment Options

The API supports multiple payment methods, including credit cards, direct debits, and open banking. This flexibility ensures that your customers can choose the payment method that suits them best, enhancing their overall experience.  

Form elements

The intent provides HTML elements for all your enabled payment options, which can be easily embedded into your site. These elements follow a standardized structure to securely tokenize card details, automatically include device fields for 3D Secure (3DS), and seamlessly submit payments in line with our modern API standards. These include elements for cards (both for MOTO and ECOM), as well as for direct debit, open banking, Apple and Google Pay.

Customizable Card Layouts

The API provides options to customize the card input layout for credit card transactions. Whether you prefer a basic layout, a single-line input, or a multi-line input, the Intents API can accommodate your design preferences, providing a consistent and clean user experience.  

Redirect URL

After a transaction is completed, the API will redirect customers to your specified URL. The URL will have parameters containing the transaction result and status.  This feature is useful for integrating the payment process into your website, ensuring a seamless transition back to your platform once the payment is made.  

Notification URL

To keep your systems informed of payment statuses, you can set a notification URL. This URL will receive a POST request with transaction details once the payment intent is fulfilled, allowing for automated tracking and record-keeping.  

Merchant and Transaction Identifiers

Each intent is associated with unique merchant and transaction identifiers, enabling easy referencing and management of payment records. These identifiers can be used to query specific intents, update transaction details, or track payment histories.

Real-Time Tracking and Management

You can retrieve and manage the details of each intent, including its status, amount, and associated merchant information. This allows for seamless tracking of payment processes and quick updates to any ongoing transactions.  

Advanced Card Features

Delay Capture

For certain transaction types, such as sales or credits, you can delay the capture of funds for a specified number of days. This feature is particularly useful for scenarios where you need to authorize a payment but wish to capture the funds at a later time.  

Security and Verification

The Intents API helps mitigate fraud and ensure that payments are securely processed with its options for pre-authorisation and card verification. These options allow you to check the validity of a card without charging the customer, and then charge them at a later date.


Endpoints Overview

  • POST intents: This endpoint allows the creation of a new payment intent, with customizable parameters such as transaction type, payment type, amount.

  • GET intents/intent_id: Retrieve detailed information about a specific payment intent using its unique identifier.  

  • PATCH intents/intent_id: Update existing payment intents by unique identifier to reflect changes in payment information, status, or other attributes.