Payment links

A link is a reusable hosted checkout with a fixed price. Create one in the dashboard or with POST /links, then share its url anywhere: your site, an invoice, a chat or a QR code.

curl -X POST "https://api.402pay.co/api/v1/links" \
  -H "Authorization: Bearer $PAY402_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Team plan, monthly",
    "amount": "199.00",
    "currency": "USD"
  }'

const response = await fetch("https://api.402pay.co/api/v1/links", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.PAY402_SECRET_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Team plan, monthly",
    amount: "199.00",
    currency: "USD"
  }),
});
const { data } = await response.json();

import os

import requests

response = requests.post(
    "https://api.402pay.co/api/v1/links",
    headers={
        "Authorization": f"Bearer {os.environ['PAY402_SECRET_KEY']}",
    },
    json={
        "name": "Team plan, monthly",
        "amount": "199.00",
        "currency": "USD"
    },
)
data = response.json()["data"]

• Price it in USD, EUR, GBP, CAD and AUD. Customers pay the equivalent in the coin they choose.
• Every payment made through a link carries its link_id, so GET /payments?link_id=… lists them.
• Archive a link to stop taking payments without losing its history. A checkout a customer already opened keeps working, so they can still finish paying or send the rest.
• A link's payment lasts as long as its quote. If the quote expires before anything arrives, the payment is expired, and the customer's next visit starts a new one.
• If the customer cancels at checkout, the link's payment is failed and you receive payment.failed. Unlike a payment you create through the API, it can't be paid again.
• A link's payments can have their remainder requested when a customer sends too little.

In the dashboard: Create a payment link.