PAYTERO DEVELOPERS

Payment checkout for your website.

Use the Paytero API to create a one-time hosted payment request, then redirect your customer to its checkout URL. Build the button and pre-checkout experience in your own site; Paytero handles the request page and sends the customer to an available operator.

Get started

Create a Paytero account, open Dashboard → Developer API, and generate an API key. Keep the key on your server; never include it in client-side JavaScript.

1. Create a payment link

POST to /api/v1/payment-links with a bearer API key. The provider can be multiple, stripe, revolut, or paypal, subject to live availability, currency, minimum amount, and operator rules. The optional brand name, color, and short message customize the Paytero request page; the operator's final payment page is not customizable by Paytero.

curl -X POST https://paytero.io/api/v1/payment-links \
  -H "Authorization: Bearer pt_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Design project",
    "customerEmail": "[email protected]",
    "payoutWallet": "0xYOUR_SELF_CUSTODIAL_WALLET",
    "amount": "100.00",
    "currency": "USD",
    "provider": "multiple",
    "clientPaysFee": true,
    "brandName": "Your business",
    "brandColor": "#1769e0",
    "checkoutMessage": "Thank you for your order."
  }'

A successful response returns id, checkout_url, and short_url. Redirect the browser to checkout_url; do not iframe the operator's page or collect card details yourself.

2. Check payment status

GET /api/v1/payment-links/{id} with the same bearer key. Status is open, paid, or expired. Only a provider-confirmed payment should be treated as paid. Do not infer success merely because the customer returned to your website.

3. Give your AI agent an MCP endpoint

Paytero exposes a Streamable HTTP MCP endpoint at https://paytero.io/mcp. A trusted client that can send a bearer API key can use tools to read this guide, create a payment link, and inspect a link's recorded status. The API key grants real link creation, so review agent actions before sharing a checkout.

ChatGPT plugin account linking requires OAuth, which this API-key endpoint does not yet provide. Claude and other clients also vary in their authentication setup; check your client's current MCP settings.

Fees and settlement

Customer-paid Paytero fee: 3%. Merchant-covered Paytero fee: 4%. Operator, exchange, and network charges may apply. Settlement uses the wallet supplied for each request; it must be an eligible self-custodial EVM wallet. Verification, availability, and timing are controlled by the selected provider.