PAYTERO DEVELOPERS

Add Paytero checkout to your website.

Create one-time payment links from your server, redirect buyers to a Paytero-hosted request page, and check the recorded payment status. Your site never handles card details.

Before you start

Create a Paytero account, open Dashboard → Developer API, and generate a key. Send it as Authorization: Bearer pt_live_…. Keep it server-side. Use an eligible self-custodial Polygon payout wallet, distinct from the affiliate wallet.

1. Create a payment link

Send POST /api/v1/payment-links. The amount is a decimal string in the selected currency. Set provider to multiple for the hosted operator-selection flow; for a direct operator, first inspect GET /api/paygate/providers for current IDs and minimums. Provider availability depends on the buyer's location, amount, currency, and operator rules.

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."
  }'

Response (the ID and codes below are illustrative):

HTTP/1.1 201 Created
{
  "id": "PAYMENT_UUID",
  "checkout_url": "https://paytero.io/pay/LONG_RANDOM_CODE",
  "short_url": "https://paytero.io/t/SHORT_CODE",
  "payment": { "status": "open", "currency": "USD", "customerAmountMinor": 10300 }
}

Store id against your own order. Redirect the buyer to checkout_url, or share short_url. Both point to the same Paytero request. Optional description, brandName, brandColor, and checkoutMessage customize Paytero's request page, not the final operator form.

2. Read the payment status

Use GET /api/v1/payment-links/{id} with the same account's bearer key. A response contains payment.status: open, paid, or expired. Paytero records provider-confirmed payments from a verified callback or an authorized dashboard status refresh. This endpoint reads the saved record; it does not poll the provider on every request. Do not fulfill an order merely because the buyer returned from checkout.

curl https://paytero.io/api/v1/payment-links/PAYMENT_UUID \
  -H "Authorization: Bearer pt_live_YOUR_KEY"

# Response: { "payment": { "id": "PAYMENT_UUID", "status": "open", ... } }

For fulfillment, poll with sensible backoff and only act when status becomes paid. Save the payment ID and make fulfillment idempotent. There is no merchant-facing Paytero webhook yet; polling is the supported external integration path.

API reference

EndpointPurposeAuthentication
POST /api/v1/payment-linksCreate a one-time link; returns HTTP 201.Bearer API key
GET /api/v1/payment-linksList links created by your account.Bearer API key
GET /api/v1/payment-links/{id}Read one of your links and its saved status.Bearer API key
GET /api/paygate/providersRead current operator IDs, status, currency, and minimum.Public

Required create fields: customerEmail, payoutWallet, amount; a meaningful title is recommended. Supported currencies are USD, EUR, CAD, GBP, SEK, and INR. Amounts must have at most two decimal places and meet the operator's minimum. clientPaysFee defaults to false.

Errors are JSON with an error string. Common statuses: 400 invalid input, 401 missing/invalid key, 404 link not owned by your account, and 502 upstream provider unavailable or rejecting link creation. A key creates real payment requests; rotate or revoke it in your dashboard if exposed.

Optional MCP endpoint

Trusted AI clients that support Streamable HTTP and bearer-token authentication can connect to https://paytero.io/mcp to read integration guidance, create links, and inspect recorded status. Review any AI-created link before sharing it. ChatGPT plugin account linking requires OAuth, which is not available on this endpoint yet.

Fees, settlement, and current limits

Customer-paid Paytero fee: 3%. Merchant-covered Paytero fee: 4%. Provider, exchange, and network charges may also apply. The actual affiliate commission is based on the final provider payout and is not proven by Paytero's estimated fee field. Payout eligibility and timing are controlled by the provider.

Paytero currently has no dedicated sandbox, merchant webhook, card-data API, or hosted checkout customization beyond the Paytero request page. Test with a legitimate small payment above the chosen operator's minimum, then confirm both the saved paid status and the on-chain payout.