Skip to content

Developers

Three ways in. Card data never touches your servers in any of them.

Which is what keeps your PCI scope small and your integration boring, in the good sense. Pick the path that matches your team, then ask for the sandbox — it is not gated on underwriting.

At a glance

Protocol
REST, JSON
Auth
Per-account API keys
Card capture
Hosted fields, tokenized
Events
Signed webhooks, replayable
Sandbox
Unlimited, production parity

Reviewed

Three ways in

Pick the one that matches your team.

Hosted checkout

No code

Most merchants

A payment page we host and secure, styled to your brand. Cards, ACH and wallets on one page. You link to it or embed it; we handle the card data, 3-D Secure and the receipt. PCI scope stays at the lightest self-assessment because nothing sensitive ever reaches your systems.

  • Brandable — your logo, colors and domain
  • Cards, ACH and wallets on one page
  • 3-D Secure and fraud rules applied server-side
  • Payment links for phone, email and text
pay.meridianbotanicals.comSandbox
Meridian Botanicals$64.00
CardBank (ACH)
4242 4242 4242 4242
09 / 28
•••
Billing ZIP
Pay $64.00

Card data is tokenized in the browser. It never reaches the merchant.

Illustrative · figures are fictional, not a quote

Cart plugins

Plugin install

Existing stores

Drop-in support for the major cart platforms, so a store that already exists moves without being rebuilt. The plugin uses hosted fields under the hood, so the PCI position is the same as hosted checkout.

  • Major platforms supported
  • Keeps your existing catalog and order flow
  • Hosted fields — card data bypasses your server
  • Same dashboard and reporting as every other channel
Meridian Botanicals/Virtual terminal
Sandbox

Amount

$1,250.00

123456789.0⌫
CardholderJ. Alvarez
AuthorizationSigned
Charge
Illustrative · figures are fictional, not a quote

REST API and hosted fields

Engineering time, scope-dependent

Teams with engineers

A documented REST API for charges, refunds, customers, subscriptions, payouts and disputes. Hosted fields you embed in your own pages tokenize card data before it touches your code. Signed webhooks for every event, replayable from the dashboard. The sandbox is unlimited and identical to production except for the keys.

  • Charges, refunds, customers, subscriptions, payouts, disputes
  • Hosted fields for tokenized card capture in your own UI
  • Signed webhooks with retry and replay
  • Idempotency keys on every write
  • Unlimited sandbox, production parity
Meridian Botanicals/Webhooks · Deliveries
Sandbox
EventEndpointStatus
settlement.postedapi.meridian…/hooks200
dispute.openedapi.meridian…/hooks200
payout.sentapi.meridian…/hooksRetrying
reserve.releasedapi.meridian…/hooks200

Signed, retried with backoff, replayable from the dashboard.

Illustrative · figures are fictional, not a quote

Where card data goes

Your server only ever sees a token.

With hosted checkout, a plugin or hosted fields, the card number is captured in a field we serve and exchanged for a token before your code runs. That is the whole reason your PCI scope stays small.
  1. Cardholder's browser

    Types the card number

  2. Hosted field

    Served by us, inside your page

  3. Token

    Stands in for the card

  4. Your server

    Never holds the card number

  5. Dash platform

    Authorizes, captures, settles

The full statement of where card data, documents and money go is on Security & trust.

Webhooks

Every event that matters, delivered to your system.

Signed so you can verify the sender, retried until you acknowledge, and replayable from the dashboard if you were down. The names below are the events the platform emits; the exact payload schema ships with your sandbox credentials.
Events8
payment.succeeded
A charge was captured and will settle
payment.failed
Declined or errored, with the reason code
refund.completed
A refund posted back to the customer
settlement.posted
A batch settled to your account, with the fee breakdown
payout.sent
An outbound payout left the platform
dispute.opened
A chargeback or pre-dispute alert was raised
dispute.resolved
Won, lost, or refunded before it posted
reserve.released
Reserve funds aged past term and released
Representative · exact schema ships with sandbox credentials
Meridian Botanicals/Webhooks · Deliveries
Sandbox
EventEndpointStatus
settlement.postedapi.meridian…/hooks200
dispute.openedapi.meridian…/hooks200
payout.sentapi.meridian…/hooksRetrying
reserve.releasedapi.meridian…/hooks200

Signed, retried with backoff, replayable from the dashboard.

Illustrative · figures are fictional, not a quote

Sandbox

Request sandbox access.

Credentials, test cards, a webhook endpoint and the reference for the products in scope — issued by a person, not gated on underwriting. Tell us what you are building.
  • Issued by a person

    Credentials come from a person, not a queue. Nothing to sign first.

  • Production parity

    Same API, same webhooks, same dashboard. Only the keys change when you go live.

  • The reference that fits you

    You get the endpoints for the products in scope, not a catalog of things your account cannot use.

What the business sells. One line is enough.

The products you expect to use — charges, ACH, payouts, subscriptions — and anything unusual about the flow.

Not gated on underwriting.

Questions

From engineers.

Issued with your sandbox credentials, alongside a named technical contact. We do not publish it openly because the endpoints available to an account depend on which products were approved at underwriting — a public reference that shows you payouts you cannot use is worse than one you receive when it is accurate for you.

Start with the sandbox, or with the file.

Engineers can have credentials now. Merchants can find out which acquiring partner writes the category before anyone writes a line of code.