✨Create Payment

In this section, you’ll learn how to create a payment link using the PayRam API for customers to make payments easily.

---

URL Details

Parameter	Description	Example
BASE_URL	Your PayRam Site URL — find it under Settings → Site URL in your dashboard. Include the port if you installed on one.	https://pay.example.com
API Endpoint	Endpoint to create a new payment link.	/api/v1/payment

Note : You can generate a unique API key for each project directly from the PayRam dashboard. This helps you manage and track payouts separately for every project.

Headers

Header	Description	Example
API-Key	Your unique PayRam API key generated from your dashboard.	811b12035f0dfa8ffd62296df3c98b27
Content-Type	Format of the request data.	application/json

Request Body

Field	Required	Description	Example
customerEmail	Yes	Customer’s email address where the payment link will be associated.	[e-mail]
customerID	Yes	Unique identifier for the customer.	1
amountInUSD	Yes	The payment amount in USD.	10
invoiceID	No	Your own invoice reference. Returned as invoice_id in the payment webhook.	INV-0090
expire	No	When the payment link expires, as an RFC 3339 timestamp. Defaults to 24 hours from creation.	2026-08-20T10:00:00Z
currency	No	Restricts the payment to a single currency. Omit to let the customer choose.	USDC
network	No	Restricts the payment to a single blockchain. Use together with currency.	BASE

Payment links expire after 24 hours by default. Once expired, the payment moves to CANCELLED. Send expire to set a different window.

curl request

Before running the command, replace the placeholders with your actual details:

• ${BASE_URL} → Your PayRam server URL

• <your_api_key> → Your PayRam API key

• Replace the request body fields with real customer data

curl --location '${BASE_URL}/api/v1/payment' \
--header 'API-Key: <your_api_key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "customerEmail": "<customer_email>",
  "customerID": "<customer_id>",
  "amountInUSD": <amount_in_usd>
}'

curl response

{
  "host": "https://pay.example.com",
  "reference_id": "c80f5363-0397-4761-aa1a-3155c3a21470",
  "url": "https://pay.example.com/payments?reference_id=c80f5363-0397-4761-aa1a-3155c3a21470&host=https://pay.example.com"
}

Note : The url field provides a ready-to-use PayRam payment page. You can share this link directly with your customers, or build a custom UI using other API endpoints.