Create a Payment Link for Checkout

The Create Payment Link endpoint accepts your order details and customer information, then returns a hosted payment URL that your customer can open to complete the transaction. Because FastFlowPe hosts the checkout page, you do not need to build any frontend to collect payments.

Quick ReferenceRequired: order_id, amount, description, customer_infoReturns: payment_link, link_id, expiryMinimum amount: ₹200

Endpoint

POST https://api.fastflowpe.com/merchant/payment-links/create

Headers

Header	Value
`x-api-key`	Your merchant API key
`Content-Type`	`application/json`

Request Body Parameters

string

required

Unique identifier for the order on your system. Use a new value for every transaction — duplicate order_id values will be rejected.

float

required

Amount to charge the customer, in Indian Rupees. Minimum value is ₹200.

string

required

A short description of the product or transaction shown to the customer on the payment page.

object

required

An object containing the customer’s contact details.

Show customer_info fields

string

required

Full name of the customer.

string

required

Email address of the customer.

string

required

10-digit mobile number of the customer, without country code.

string

UUID of a specific PSP provider to route this payment through. Retrieve available provider IDs from the Get PSP Providers endpoint. If omitted, FastFlowPe selects the provider automatically.

string

ISO 8601 datetime string specifying when the payment link expires. For example: 2026-08-29T12:12:09.823481+05:30. If omitted, the platform default expiry applies.

curl --location 'https://api.fastflowpe.com/merchant/payment-links/create' \
--header 'x-api-key: <x-api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id": "ORD_4421",
    "amount": 500,
    "description": "Premium Subscription",
    "customer_info": {
        "name": "John Doe",
        "email": "john@example.com",
        "phone": "9999999999"
    },
    "expiry": "2026-08-29T12:12:09.823481+05:30"
}'

import requests

url = "https://api.fastflowpe.com/merchant/payment-links/create"
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json",
}
payload = {
    "order_id": "ORD_4421",
    "amount": 500,
    "description": "Premium Subscription",
    "customer_info": {
        "name": "John Doe",
        "email": "john@example.com",
        "phone": "9999999999",
    },
    "expiry": "2026-08-29T12:12:09.823481+05:30",
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://api.fastflowpe.com/merchant/payment-links/create", {
  method: "POST",
  headers: {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    order_id: "ORD_4421",
    amount: 500,
    description: "Premium Subscription",
    customer_info: {
      name: "John Doe",
      email: "john@example.com",
      phone: "9999999999",
    },
    expiry: "2026-08-29T12:12:09.823481+05:30",
  }),
});
console.log(await response.json());

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String body = """
{
  "order_id": "ORD_4421",
  "amount": 500,
  "description": "Premium Subscription",
  "customer_info": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "9999999999"
  },
  "expiry": "2026-08-29T12:12:09.823481+05:30"
}
""";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.fastflowpe.com/merchant/payment-links/create"))
    .header("x-api-key", "<x-api-key>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := []byte(`{
        "order_id": "ORD_4421",
        "amount": 500,
        "description": "Premium Subscription",
        "customer_info": {"name": "John Doe", "email": "john@example.com", "phone": "9999999999"},
        "expiry": "2026-08-29T12:12:09.823481+05:30"
    }`)

    req, _ := http.NewRequest("POST", "https://api.fastflowpe.com/merchant/payment-links/create", bytes.NewBuffer(payload))
    req.Header.Set("x-api-key", "<x-api-key>")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

<?php
$payload = json_encode([
    "order_id" => "ORD_4421",
    "amount" => 500,
    "description" => "Premium Subscription",
    "customer_info" => [
        "name" => "John Doe",
        "email" => "john@example.com",
        "phone" => "9999999999",
    ],
    "expiry" => "2026-08-29T12:12:09.823481+05:30",
]);

$ch = curl_init("https://api.fastflowpe.com/merchant/payment-links/create");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: <x-api-key>",
    "Content-Type: application/json",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.fastflowpe.com/merchant/payment-links/create')
request = Net::HTTP::Post.new(uri)
request['x-api-key'] = '<x-api-key>'
request['Content-Type'] = 'application/json'
request.body = {
  order_id: 'ORD_4421',
  amount: 500,
  description: 'Premium Subscription',
  customer_info: {
    name: 'John Doe',
    email: 'john@example.com',
    phone: '9999999999',
  },
  expiry: '2026-08-29T12:12:09.823481+05:30',
}.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body

The order_id must be unique for every transaction. Reusing an existing order_id will cause the request to fail.

Use the psp_provider_id field to route a payment to a specific payment provider. Call the Get PSP Providers endpoint to retrieve the UUID for each provider available to your account.

⌘I

curl --location 'https://api.fastflowpe.com/merchant/payment-links/create' \
--header 'x-api-key: <x-api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_id": "ORD_4421",
    "amount": 500,
    "description": "Premium Subscription",
    "customer_info": {
        "name": "John Doe",
        "email": "john@example.com",
        "phone": "9999999999"
    },
    "expiry": "2026-08-29T12:12:09.823481+05:30"
}'

import requests

url = "https://api.fastflowpe.com/merchant/payment-links/create"
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json",
}
payload = {
    "order_id": "ORD_4421",
    "amount": 500,
    "description": "Premium Subscription",
    "customer_info": {
        "name": "John Doe",
        "email": "john@example.com",
        "phone": "9999999999",
    },
    "expiry": "2026-08-29T12:12:09.823481+05:30",
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://api.fastflowpe.com/merchant/payment-links/create", {
  method: "POST",
  headers: {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    order_id: "ORD_4421",
    amount: 500,
    description: "Premium Subscription",
    customer_info: {
      name: "John Doe",
      email: "john@example.com",
      phone: "9999999999",
    },
    expiry: "2026-08-29T12:12:09.823481+05:30",
  }),
});
console.log(await response.json());

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String body = """
{
  "order_id": "ORD_4421",
  "amount": 500,
  "description": "Premium Subscription",
  "customer_info": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "9999999999"
  },
  "expiry": "2026-08-29T12:12:09.823481+05:30"
}
""";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.fastflowpe.com/merchant/payment-links/create"))
    .header("x-api-key", "<x-api-key>")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    payload := []byte(`{
        "order_id": "ORD_4421",
        "amount": 500,
        "description": "Premium Subscription",
        "customer_info": {"name": "John Doe", "email": "john@example.com", "phone": "9999999999"},
        "expiry": "2026-08-29T12:12:09.823481+05:30"
    }`)

    req, _ := http.NewRequest("POST", "https://api.fastflowpe.com/merchant/payment-links/create", bytes.NewBuffer(payload))
    req.Header.Set("x-api-key", "<x-api-key>")
    req.Header.Set("Content-Type", "application/json")

    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

<?php
$payload = json_encode([
    "order_id" => "ORD_4421",
    "amount" => 500,
    "description" => "Premium Subscription",
    "customer_info" => [
        "name" => "John Doe",
        "email" => "john@example.com",
        "phone" => "9999999999",
    ],
    "expiry" => "2026-08-29T12:12:09.823481+05:30",
]);

$ch = curl_init("https://api.fastflowpe.com/merchant/payment-links/create");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "x-api-key: <x-api-key>",
    "Content-Type: application/json",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

require 'net/http'
require 'uri'
require 'json'

uri = URI('https://api.fastflowpe.com/merchant/payment-links/create')
request = Net::HTTP::Post.new(uri)
request['x-api-key'] = '<x-api-key>'
request['Content-Type'] = 'application/json'
request.body = {
  order_id: 'ORD_4421',
  amount: 500,
  description: 'Premium Subscription',
  customer_info: {
    name: 'John Doe',
    email: 'john@example.com',
    phone: '9999999999',
  },
  expiry: '2026-08-29T12:12:09.823481+05:30',
}.to_json

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body

Get Started

Collections

Payment Links

Fund Transfer

Refunds

Callbacks

Create a Payment Link for Checkout

Endpoint

Headers

Request Body Parameters

​Endpoint

​Headers

​Request Body Parameters

Endpoint

Headers

Request Body Parameters