Skip to main content
Payment Links define the parameters of a payment intent executed through the Commerce Payments Protocol. The fields below control how the payment behaves – its token, fees, expiries, redirects, and the addresses involved in authorization, capture, and refund operations.

​
Contract settings

FieldDescriptionDefault
contractAddressCommerce Payments Protocol address0xBdEA0D1bcC5966192B070Fdf62aB4EF5b4420cff
operatorOperator address handling the payment—
receiverAddress that receives the payment—
tokenERC-20 token address for paymentUSDC on Base
networkIdBlockchain network identifier8453 (Base)

​
Fee settings

FieldDescriptionDefault
minFeeBpsMinimum fee in basis points0
maxFeeBpsMaximum fee in basis points0
feeReceiverAddress that receives the fee0x0000...0000

​
Expiration and redirect settings

FieldDescriptionDefault
preApprovalExpiryWhen the pre-approval expires (Unix timestamp)now + 1 day
authorizationExpiryWhen the authorization expires (Unix timestamp)now + 7 days
refundExpiryWhen the refund window expires (Unix timestamp)now + 7 days
successRedirectUrlURL to redirect after successful payment—
failRedirectUrlURL to redirect after failed payment—
successCallbackUrlCallback URL on successful payment pre-approval—

​
Merchant and customer information

Payment links can include optional merchant and customer metadata: 
{
  "merchant": {
    "name": "MerchantName",
    "logoUrl": "https://example.com/logo.png",
    "locale": "en-US",
    "metadata": {}
  },
  "customer": {
    "locale": "en-US",
    "metadata": {}
  },
  "fiat": {
    "amount": "10.00",
    "currency": "USD",
    "metadata": {}
  }
}