Versions Compared

Key

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

...

  • It only works when the payment is made, cannot be used to pull previous transaction data or update transaction status.

  • It is only available for Card transactions, not Open Banking or Direct Debit Transactions.

  • The Callback URL will send all transactions, including declined transactions. Ecom transactions may be recorded multiple times due 3D-Secure authentication requirements.

  • A developer (junior-level) will may be needed to format the data.PLACE SERVER REQUIREMENTS HERE

  • The Callback URL must be a fully qualified URL, containing at least the scheme and host components.

Implementation

To receive transaction data from transaction done directly on Blink (Take A Payment, Request A Payment and Blink Pages), navigate to your Blink Page Customiser, which is found in the Customer Centre section of Blink. Click on the Merchant Shop Settings to open the payment settings for this Blink page. You will find Enter the URL which will receive the request into the Callback URL input. Please ensure you have entered the whole URL, including “https://” (not “www”).

Callback URL on Integrations

The Callback URL is available for Direct and Hosted integrations. When creating the post request to the Blink Gateway, please add the callbackURL parameter with the value being the URL which will receive the request. Please ensure you have entered the whole URL, including “https://” (not “www”).

Available Fields

Variable

Description

Example

Response Code

Code indicating whether transaction was successful (0) or if there is an issue with the transaction (error code)

Successful transactions = 0

3ds Authentication Required = 65802

Response Message

Message indicating the transaction was successful or Error message.

AUTHCODE:121590

state

Captured or Declined

authorisationCode

121590

merchantID

Your unique Gateway ID which processed the transaction

138791

customerName

Name of customer

Fred Bloggs

customerEmail

Email of customer

f.bloggs@example.com

customerAddress

Billing address of customer (required for AVS checking)

76 Roseby Avenue

Manchester

customerPostcode

Post Code of customer (required for AVS checking)

M63X 7TH

amount

Amount customer was charged

Is given in the smallest value e.g. pennies

1000 (10.00)

currencyCode

ISO 4217 of the currency which was charged with

826 (for GBP)

currencySymbol

Symbol of the currency which was charged with

£ (for GBP)

transactionUnique

Reference

InvoiceNumber1

orderRef

Description

Blink - BP

transactionID

Unique ID of Transaction

198662389

cardScheme

Card scheme of the customer’s card

Visa

cardType

Card type of the customer’s card

Visa Credit

cardNumberMask

First 5 and last 4 digits of the customers PAN number

454305******9982

cardExpiryDate

Date the card expires

1222

cardExpiryMonth

Month the card expires

12

cardExpiryYear

Year the card expires

22

cardIssuer

Bank associated with customer’s card

THE ROYAL BANK OF SCOTLAND PLC

cardIssuerCountry

Country of the customer’s bank

United Kingdom

Recommended Formatting

Format amount

format expire date

3ds

distinguish between declines and captured/ recieved