Integration guide

Create a payment link on your server, redirect the customer to it, and confirm the payment before you fulfill the order. The API is at https://mantepay.com. It takes no API key.

Create a payment link

POST /api/sessions

const res = await fetch("https://mantepay.com/api/sessions", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    merchant: "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
    amountCents: 2500,
    returnUrl: "https://shop.example/thanks?order=42",
  }),
});
const { id, url } = await res.json();

The response is 201:

{
  "v": 1,
  "id": "0x4f1c…e9a2",
  "url": "https://mantepay.com/pay#AnCZeXDF…",
  "merchant": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
  "amountCents": 2500,
  "maxFeeBps": 1000,
  "expiresAt": 1800003600,
  "returnUrl": "https://shop.example/thanks?order=42"
}

id identifies the payment. Store it with the order. url is the payment page. expiresAt is in Unix seconds.

Redirect the customer

Send the customer to url. A link can be paid once and stops working at expiresAt. If an attempt fails, the customer can try again on the same link.

After a successful payment the page shows a button to returnUrl. It does not redirect automatically, and the customer may not return.

Check the payment status

GET /api/sessions/{id}

id is the value returned when you created the link.

const res = await fetch(`https://mantepay.com/api/sessions/${id}`);
const payment = await res.json();
if (payment.status === "paid") {
  // fulfill the order
}

The response for a paid payment:

{
  "v": 1,
  "id": "0x4f1c…e9a2",
  "status": "paid",
  "merchant": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",
  "amountCents": 2500,
  "payout": "24.25",
  "paidAt": 1800000300
}

merchant, amountCents, payout and paidAt are present once the status is paid. payout is the USDC you received, after the fee, and paidAt is in Unix seconds.

There are no webhooks. Poll this endpoint, for example when the customer reaches your returnUrl, and until expiresAt for orders that are still waiting.

Amounts and fees

• Amounts are in US dollars and are paid out in USDC.
• There is a minimum and a maximum amount. A request outside them is rejected with 400 and the range, for example amountCents: must be between 1000 and 50000.
• Payments are funded by independent acquirers, who keep a fee from the amount. You receive the amount less that fee, which never exceeds maxFeeBps. At the default of 10% a $25.00 payment pays at least $22.50. At 3% it pays 24.25 USDC.
• If no acquirer will fund a payment at your maxFeeBps, the customer's card is not used and the link stays pending.

What the customer sees

The payment page shows the amount and the merchant address, then the card form. Card details are encrypted in the customer's browser. Above the card fields the page states:

Testing

In test mode the payment page says so, no retailer is contacted and nothing is charged. Use any future expiry date and any three-digit security code. Do not enter a real card. The demo shop creates a payment link, sends you to pay it and checks the payment status when you come back.

Errors

A failed request returns {"error": "…"} with one of these statuses.