Payoes API

Built for developers first

Every Payoes feature starts with an API. Create payments, checkout sessions, payment links, invoices, and customers from your codebase, and let Payoes handle the blockchain.

One request to get paid

Create a payment and share the checkout URL it returns. Wallet connection, on-chain verification, and settlement are handled for you.

How one payment works

  1. 1

    Create a payment

    One API call returns a payment and a hosted checkout URL.

  2. 2

    Customer pays

    They open the checkout page, connect any Stellar wallet, and approve. No account needed.

  3. 3

    Settled and notified

    Payoes verifies the payment on-chain, settles to your wallet, and fires a webhook.

Five resources, one predictable API

Stripe-style objects and IDs, Bearer key authentication, and JSON everywhere. If you have integrated a payment API before, you already know this one.

Payments

pay_

POST /v1/payments

Create a payment and get back a hosted checkout URL. Track status from created to completed.

Checkout Sessions

cs_

GET /v1/checkout-sessions/{id}

Retrieve hosted checkout sessions created from finalized invoices or payment link visits.

Payment Links

plink_

POST /v1/payment-links

Reusable links that spawn a fresh checkout session on every visit.

Invoices

inv_

POST /v1/invoices

Draft, finalize, and collect invoices with hosted payment pages.

Customers

cus_

POST /v1/customers

Organize payers with profiles, wallet addresses, and payment history.

Webhooks included

React to every payment event in real time.

Learn about webhooks

Everything around the API

  • Environment-scoped API keys

    pk_test_ keys hit Stellar Testnet, pk_live_ keys hit Mainnet. Keys never cross environments and can be revoked at any time.

  • Scoped permissions

    Grant each key read or write access per resource, from payments to customers. Requests outside a key's scope are rejected.

  • API logs

    Every request is logged with method, path, status code, and duration, inspectable in the dashboard.

  • HMAC-signed webhooks

    Payment lifecycle events signed with your endpoint secret and retried automatically for up to 24 hours.

  • Free sandbox

    A full Testnet environment for every business. Test the entire payment flow end to end before going live.

  • Open source

    Audit the code, contribute, or self-host the entire platform.

Payoes API

Ship your integration this afternoon

Free sandbox on Stellar Testnet. No credit card required.

← Back to home