Payment Overview
Pay by Link

Overview

The Pay By Link feature allows you to create a secure payment request link, which can be sent directly to customers to initiate payment collection. Upon clicking the link, Volume handles the payment capture, authorization, and initiation processes seamlessly.

This feature offers a convenient, secure solution for sending a fixed-amount payment request link to end users, ensuring a smooth and efficient payment experience. The generated link can be shared through various channels, including email, SMS, or other preferred methods of communication.

Request

curl --location --request POST 'https://api.sandbox.volumepay.io/api/paymentintents/link' \
--header 'x-application-id: {application-id}'
--header 'x-application-secret: {application-secret}'
--header 'Content-Type: application/vnd.volume.v0.7+json' \
--header 'Accept: application/vnd.volume.v0.7+json' \
--data-raw '{
    "applicationId": {application-id},
    "customerIntentDescription": null,
    "merchantIntentDescription": null,
    "merchantPaymentId": "merchantPaymentId",
    "paymentRequest":  {
        "amount": 5,
        "currency": "GBP",
        "reference": "reference"
    }
}'
argumentkindtypedescription
application-idheaderUUIDid of the merchant application
application-secretheaderUUIDprivate key of the merchant application
Content-TypeheaderStringapplication/vnd.volume.v0.7+json
AcceptheaderStringapplication/vnd.volume.v0.7+json
applicationIdbodyUUIDid of the merchant application
customerIntentDescriptionbodyStringdescription of the payment for customer
merchantIntentDescriptionbodyStringdescription of the payment for merchant
merchantPaymentIdbodyStringmerchant payment id
amountbodyNumberamount to pay
currencybodyStringcurrency of the payment
referencebodyStringreference of the payment

applicaiton-secret can be generated in Merchant Portal -> Settings -> Security

Response

{
  "paymentIntentId": "{paymentIntentId}",
  "paymentIntentLink": "https://sandbox.paybylink.volumepay.io/?paymentIntentId={paymentIntentId}",
  "customerIntentDescription": null,
  "merchantIntentDescription": null,
  "expiryTimeUtc": "2024-08-21T15:50:38.339227886",
  "merchantName": "Merchant Name",
  "applicationId": "{applicationId}",
  "merchantPaymentId": "null",
  "paymentRequest": {
    "amount": 5,
    "currency": "GBP",
    "reference": "payment reference"
  },
  "isLink": true,
  "usageMode": "ALLOW_MULTIPLE_ATTEMPTS",
  "tracingId": "7375828018350538150"
}
fieldtypedescription
paymentIntentIdUUIDpaymentIntentId
paymentIntentLinkStringlink to pay by link page with bank selector
customerIntentDescriptionStringdescription of the payment for customer
merchantIntentDescriptionStringdescription of the payment for merchant
expiryTimeUtcStringlink expiry time
merchantNameStringmerchant name
applicationIdUUIDid of the merchant application
merchantPaymentIdstring [optional]merchant payment id if specified when payment was initialized
amountnumberamount to pay
currencystringcurrency of the payment
referecestringreference of the payment
isLinkbooleantrue if payment intent was initialized as pay by link
usageModestringusage mode: ALLOW_MULTIPLE_ATTEMPTS, ALLOW_SINGLE_ATTEMPT
tracingIdstringcall tracingId (for support)

Webhook Notification will be sent when payment is completed.