Skip to main content

​
Overview

Secure Payment Pages let you generate a hosted payment URL from the API and redirect the payer to a dedicated payment experience. This feature is useful when you want to reduce frontend tampering risk and separate payment execution from your checkout UI.

​
Built-in contract safety check

Before signing, the secure page validates that the transaction targets official Request Network contracts. The payer-facing status copy is:
  • “This is a safe smart contract”
  • “The smart contract you are interacting with is an official Request Network smart contract, it is audited and valid.”
If validation fails, the secure page warns the payer and prevents continuing with unsafe contract interactions.

​
How the flow works

1

Create a secure payment link

Call POST /v2/secure-payments with one or more requests.The API creates Request records and returns:
  • requestIds
  • token
  • securePaymentUrl
2

Redirect the payer to the hosted page

Send the payer to securePaymentUrl.
3

Payer reviews payment details

The hosted page loads the payment details and prepares the required transaction flow.
4

Sign and submit payment transactions

The payer signs the returned transaction set from their wallet. Depending on token approvals, this can be one or more transactions.

​
Authentication

Both secure payment endpoints accept:
  • x-api-key, or
  • x-client-id with browser Origin
See Authentication for implementation options.

​
API Reference

POST /v2/secure-payments

Create a secure payment entry and return a hosted secure payment URL. View the complete endpoint documentation with request/response schemas and examples.

​
Crosschain Support

Secure payment pages support crosschain payments. When a payer connects their wallet, the page fetches balance information across supported chains via the paymentOptions field. The payer can select which chain and token to pay from, and the page fetches executable calldata for the selected route. Supported crosschain currencies: USDC, USDT Supported crosschain chains: Ethereum, Arbitrum, Base, OP Mainnet See Crosschain Payments for details on crosschain routing via LiFi.

​
Smart Account Payments

The secure payment page supports gas-sponsored payments via Alchemy Account Kit smart accounts (ERC-4337). When available, payers can use a smart account to execute payments without paying gas fees. How it works:
  1. The payer approves a spending cap from their EOA wallet to the smart account
  2. The smart account batches the transferFrom (EOA to smart account) and the payment transaction into a single UserOperation
  3. Gas is sponsored via an Alchemy gas policy — the payer pays zero gas
Smart account payments are a client-side feature of the hosted secure payment page. There is no separate API for smart accounts — the same GET /v2/secure-payments/:token/pay endpoint provides the transaction calldata.

​
Status outcomes

  • 200: token is valid and payable
  • 403: token expired or status is not payable
  • 404: token not found
  • 409: payment already completed

​
Next pages

Secure Payments API Reference

Endpoint details, request and response schemas, and error codes.

Supported Networks and Currencies

Check supported chain and currency coverage before creating links.