Pay Link

It is possible to send a Pay Link to a customer. This enables customers to receive a ready-to-pay checkout session where they can finalize the purchase on their own device by identifying themselves and selecting a payment option

The rest of the flow will be the same as for a regular Checkout session i.e. the notification callback to your system will be performed once the purchase is successful and if you have implemented the validate call it will be performed as usual.

Pay Link Request

To push a Pay Link you must first create the Checkout session as you normally do by following the Basic Steps here

Once you have created a Checkout session this can be pushed to an end customer by issuing a POST request as per below:

/*
POST /merchants/123/checkouts/1eec44b5-66d3-4058-a31f-3444229fb727/paylink HTTP/1.1
Host: checkout-api-uat.collector.se
Content-Type: application/json
Authorization: SharedKey bXlVc2VybmFtZTpmN2E1ODA4MGQzZTk0M2VmNWYyMTZlMDE...
*/
{
"destination": {
"mobilePhoneNumber": "0730481277"
}
}

The request body should contain a json object with the receivers mobile telephone number.

Please note

Currently the only distribution type available is by mobile phone number.

Request Properties

Request headers

HeaderRequiredExplanation
AuthorizationYesThe authorization header is generated with the access credentials (username and shared access key) received from Collector Merchant Services. Instructions on how to generate the authorization header value can be found under the authorization section.

Request properties

PropertyRequiredExplanation
destination.mobilePhoneNumberYesThe recepients mobile phone number. Currently the phone number must match the country where the purchase is made. Country prefix will automatically be added if needed, i.e. +46730 and 0730 are both accepted as start of a valid phone number.

Error responses

Error codeError ReasonCause
400Validation_ErrorThe request contains properties with invalid values. Details are provided in the response body.
503Could not notify customerThe service provider to push a pay link returned an error or was unavailable.