API Reference

Building Pay1st Payment Links

Use this API to build the payment links which are to redirect from the Partner’s Platform to the Pay1st Gateway.

Used in Gateway Integration

Overview

Once all the API endpoints have been integrated, it should be possible to build a Pay1st Payment Link. This API uses the Hosted Payments Redirect URL pattern in order to complete payments on the Pay1st gateway.

Pre Requisites

The following needs to be in place before building a Pay1st Payment Link

API Description

URL Format

https://<payments_base_url>/checkout?channelId=<CHANNEL_ID>&reference=<REFERENCE>&accessToken=<ACCESS_TOKEN>

List of Query Parameters

These are the list of query parameters that needs to be passed from the Pay1st Partner to the Pay1st Gateway.

NameTypeDescription
channelIdStringThis is the channelID. When this field is excluded, then the Customer will have the option to choose amongst all available payment methods.
referenceStringThis is the Pay1st Reference from the response of the Create Payment Request API
accessTokenStringThis is a URL escaped version of the Access Token that is used in the request