Create Payment
Purpose: Initiates a new payment session and returns a redirect URL where the customer can complete the transaction. This can be used for checkout pages, payment links, or embedded widget flows.
HTTP URL
https://secure.jken.me/api/v1/merchant/payment
HTTP Method
GET
Behavior
Redirect – The API responds with a URL to redirect the customer to the Link2Pay payment page.
Parameter
Type
Required
Max Length
Description
merchantId
String
Yes
4
Unique identifier for each merchant provided by L2P
appId
String
Yes
128
Unique identifier for each application provided by L2P
apiKey
String
Yes
128
Unique key for each application provided by L2P
merchantRef
String
Yes
30
A unique identifier generated by the merchant
orderNo
String
Yes
30
An order number
amount
String
Yes
36
The amount of the transaction, maximum 18 decimals
expiresIn
String
Yes
9
The time limit (in milliseconds) the customer has to complete the payment
field1
String
No
255
Merchant-defined field.Recommended for passing a URL encoded image to be displayed on the L2P payment page
field2
String
No
255
Merchant-defined field
field3
String
No
255
Merchant-defined field
field4
String
No
255
Merchant-defined field
field5
String
No
255
Merchant-defined field
customerPhone
String
No
24
Customer's phone number
customerEmail
String
No
255
Customer's email address
customerId
String
No
255
Customer ID information. Ensure customer ID is unique at the merchant
callbackUrl
String
No
128
The merchant's website URL for redirecting the response
secureHash
String
Yes
64
A hash used by the merchant to authenticate the response and ensure data integrity. (See Section 7 for secureHash generation)
Request example
https://secure.jken.me/api/v1/merchant/payment?merchantRef=1742293403387&amount=99.99&expiresIn=900000&orderNo=nabajry&field1=https%3A%2F%2Fi.etsystatic.com%2F50470297%2Fr%2Fil%2Ff72197%2F5779582788%2Fil_1588xN.5779582788_nhs2.jpg&field2=&field3=&field4=&field5=&callbackUrl=https%3A%2F%2Fdemo.jken.me%2F&secureHash=fdc22ec0d092dd85d4d1f71f997e7b7ed0d2c9902c4c2f237472f334b91baa4c&apiKey=-h6WkuE1EJHaMu9ZfPUb6O3c_L6nShTD&appId=8acde9eb3281&merchantId=b48fLast updated