FinCobra Docs

Appearance

Payment Page ​

Each invoice has a public payment page that customers can use to complete their payment. No authentication is required.

Hosted Payment URL ​

https://fincobra.com/pay/:id

Where :id is the invoice UUID returned when you create an invoice.

The invoice API returns this URL as paymentUrl. Store it with your order and redirect the customer to it when they choose to pay.

Features ​

The hosted payment page includes:

  • Payment instructions for the selected method
  • Wallet connection for supported Ethereum payment methods
  • QR codes and copy buttons for address-transfer methods
  • Live status updates while the invoice is active
  • Invoice identity fields such as issuedBy and billTo when set
  • Immediate invoice countdowns and due-date invoice timing
  • Redirect to your configured redirectUrl when the payer-facing flow completes

Linking customers to the page ​

The invoice API returns paymentUrl. Link customers directly to that URL:

html
<a href="https://fincobra.com/pay/a1b2c3d4-..."> Pay now </a>

The hosted page is intended to open directly in the browser. It is not designed for iframe embedding.

Redirects ​

Set a default redirect URL in the dashboard, or pass redirectUrl when creating an invoice. When the payer-facing flow completes, the hosted page redirects the customer to that URL.

Do not use the redirect as your only proof of payment. Use verified webhooks, or fetch the invoice status from your server, before fulfilling the order.

Building a custom payment page ​

Most integrations should use the hosted payment page. If you need a custom payment page, use the public payment-page API documented in API Reference.

The public payment-page API is unauthenticated because it powers customer-facing invoice pages. Do not put private merchant metadata, internal customer IDs, or secrets in customer-facing invoice fields.