Developer guides

Two calls to a duty and tax quote.

Classify a product, quote the duty and tax owed at its destination, and keep your live secret key on your server. The API reference carries the complete request and response contract for every call.

Integration path

Start here

  1. 01 Store your live key Put sk_live_* in your server environment. Never expose it in browser code, source control, logs, or recordings.
  2. 02 Classify the product Call POST /v1/classifications to get the HS tariff code the quote request needs.
  3. 03 Quote the duty and tax Pass the HS code to POST /v1/tax_quotes with integer minor-unit amounts and the destination country.
  4. 04 Carry the quote into checkout Keep the returned quote id, then follow the full walkthrough to add browser tokenization and an idempotent payment.

Walkthrough

Core API

Public setup walkthrough

Custom API walkthrough

Follow the public sample store from a test checkout through local setup with a Test secret key and publishable key.

The public production store runs the current 0.9.5 tax-quote contract with durable order persistence and signed-webhook reconciliation ready. Its daily transaction cap is 50.

Checkout admissions are enabled, and public Sandbox evidence shows succeeded Custom API transactions. Exact durable-order and signed-webhook reconciliation remains pending before the lifecycle is accepted.

Watch the Custom API walkthrough · Written guide · Open the public reference store.

Guided setup walkthrough

Medusa walkthrough

Go from package setup through the quote-to-payment flow. The package's webhook handling remains unsupported, so merchants use polling fallback rather than treating any protected demo receiver as package callback support.

The capped public production-Sandbox store runs the current tax contract and has reconciled an accepted payment, cancellation, and signed callbacks. The separate keyless preview remains available for visual exploration only.

Written guide · Open the public Sandbox store · Keyless preview.

Walkthrough

Commerce platforms

Sandbox transaction proof

WooCommerce end-to-end walkthrough

The branded sample store, native product and cart, Blocks success, a completed 3DS challenge, and the classic-checkout decline-to-retry flow. The public store uses fictional products and Open Border sandbox payment rails. Its persisted commerce orders, Test payment intents, signed lifecycle deliveries, and Sandbox dashboard transactions reconcile without moving live money.

The current public download is immutable release 0.2.3. The store's current installed version must be proven from the host and is not inferred from the candidate artifact lock. This 23-second clip is transaction proof, not install or configuration setup proof. Only provider-approved Test payment data is used; no credentials, card data, customer data, or internal identifiers are shown.

Written setup guide · Open the public sandbox store.

Public catalog preview

Magento end-to-end walkthrough

The recording documents the maintained Luma product and cart flow. The current installable release and staging runtime are 0.1.12.

The retained exact-one Sandbox order, tax quote, payment intent, and terminal signed webhook reconciled on 0.1.7. Shipment fulfillment later succeeded on the production demo's immutable 0.1.8 runtime without another payment. Production deployment, provenance, and signed-out smoke passed. The public demo remains preview-only until the shared-Sandbox lifecycle and dispute UI evidence-field prefill are recorded.

Written setup guide · Open the public Magento product preview.

Historical setup preview

Magento 0.1.8 installation and setup

The maintained package commands, the immutable Composer artifact check, Magento services and installation, Admin payment configuration, and the running Luma storefront. The video verifies exact release 0.1.8; the written guide installs the current immutable 0.1.12 release.

Read the current 0.1.12 steps in writing. A fresh 0.1.12 setup walkthrough, or explicit product-owner acceptance of this historical preview, remains pending.

Written

Setup guides

Every walkthrough above has a written equivalent: the same setup, step by step, from prerequisites through a test payment to going live. Readable on a slow connection, with a screen reader, or alongside the video.

  • WooCommerce Install the Open Border payment gateway on WooCommerce, configure it, take a sandbox card payment through both Blocks and classic checkout, and switch to live.
  • Adobe Commerce and Magento Open Source Install the Open Border payment module on Adobe Commerce or Magento Open Source, configure it in the Admin panel, take a sandbox card payment through native checkout, and switch to live.
  • Medusa Install the Open Border payment and tax provider in a Medusa v2 store, register it, wire the quote-then-pay checkout flow, take a sandbox card payment, and switch to live.
  • Custom API and JavaScript drop-in Take a card payment on any storefront: classify a product, quote duty and tax, collect the card in the browser, and create the charge from your own server with an idempotency key.
  • Model Context Protocol Publicly available for any merchant to connect a compatible MCP client to three read-only Open Border Sandbox tools using your own Sandbox Test secret key.
  • Salesforce B2C Commerce (SFRA) Review the Open Border cartridge pair for Salesforce B2C Commerce SFRA, its tax and duty boundary, its Business Manager metadata, and the storefront proof required before it can support a sandbox payment pilot.

Commerce plugins

Integration readiness

Implementation, release artifacts, demos, walkthroughs, test transactions, and marketplace listings are tracked as separate gates. A published pilot package does not mean its marketplace listing is approved.

Complete Pending

Commerce plugin release readiness. Each row is one gate; each column is one plugin.
Release gate WooCommerce Public download 0.2.3 Adobe Commerce / Magento Public immutable Composer release 0.1.12 Medusa Public npm 0.9.7 Salesforce B2C Commerce Public immutable cartridge release 0.1.2
Created Complete. Plugin source and deterministic package Complete. Magento payment gateway module Complete. Payment and tax provider plugin Complete. SFRA cartridge source and package tooling
Published Complete. Public immutable ZIP, checksum, and manifest 0.2.3 Complete. Public immutable Composer ZIP, checksum, and manifest Pending. Public npm 0.9.7 integrity and offline SDK checks passed; requested-source acceptance pending Complete. Public immutable cartridge ZIP, checksum, and manifest
Demo Complete. Public production-Sandbox store; persisted lifecycle reconciled Pending. Production catalog preview runs immutable 0.1.8 and passed production deployment, provenance, and signed-out smoke; the current installable release and staging runtime are 0.1.12, while the shared-Sandbox lifecycle and dispute UI prefill remain open Complete. Public capped production-Sandbox store; accepted lifecycle reconciled Pending. Hosted sandbox and Business Manager access pending
Video tutorial / setup Pending. No setup recording is cleared for publication; the checkout clip is transaction proof only Pending. Current 0.1.12 installation and configuration walkthrough pending Complete. Install, configure, and transact walkthrough; package webhook handling remains not supported, so use polling fallback Pending. Setup walkthrough pending
Written setup guide Complete. Step-by-step written setup Complete. Step-by-step written setup Complete. Step-by-step written setup Pending. Published, pending verification against a storefront
Video test transaction Complete. Sandbox checkout, 3DS, decline, and retry Pending. Historical 0.1.7 lifecycle evidence retained; current 0.1.12 transaction proof or product-owner acceptance pending Complete. Sandbox transaction walkthrough Pending. Hosted sandbox transaction recording pending
Marketplace listing Pending. WordPress.org and Woo Marketplace pending Pending. Seller onboarding and extension review pending Complete. Canonical public npm registry listing Pending. Salesforce LINK partner distribution pending

All integrations

Coverage matrix

Canonical guide paths, public resource availability, ownership, active dependencies, and the verification date are recorded per integration.

All integration coverage, availability, ownership, dependencies, and verification dates.
IntegrationCanonical guideDemoSetup videoWritten guideArtifactOwnerActive dependencyLast verified
WooCommerce/guides/woocommerceDemo (Public)Public WooCommerce demo with fictional products on Open Border sandbox rails.Setup video (Blocked)No setup recording is currently cleared for publication. The separate public checkout clip is transaction proof, not installation or configuration setup proof.Written guide (Public)Public download 0.2.3 · Blocks and classic checkoutPayments demo operationsSanitized current setup walkthrough, WordPress.org, and Woo Marketplace approval2026-08-24
Adobe Commerce and Magento Open Source/guides/magentoDemo (Preview)Production catalog preview runs immutable 0.1.8 and passed production deployment, provenance, and signed-out smoke. The current installable release is 0.1.12; maintained-store deployment and checkout proof remain separate. Retained exact-one lifecycle evidence is from 0.1.7; the shared-Sandbox lifecycle and dispute UI prefill remain open.Setup video (Preview)Sanitized exact-0.1.8 artifact verification, Composer installation, and Magento 2.4.8-p5 Admin configuration walkthrough; the payment method remains disabled and the recording stops before checkout.Written guide (Public)Public immutable Composer release 0.1.12 · native Luma checkoutPayments demo operationsCurrent 0.1.12 setup walkthrough or product-owner acceptance, production demo upgrade, shared-Sandbox lifecycle, dispute UI prefill, and marketplace listing2026-09-03
Medusa/guides/medusaDemo (Public)The public runtime uses the current tax contract and has reconciled its accepted payment, cancellation, and signed callback lifecycle under server-side caps.Setup video (Public)Install, configure, and transact walkthrough; package webhook handling remains not supported, so use polling fallback.Written guide (Public)Source 0.9.7 · current public npm package 0.9.7 · Medusa v2 Payment ModulePayments demo operationsPackage webhook projection remains not supported; merchants use polling2026-08-24
Custom API and JavaScript drop-in/guides/custom-apiDemo (Public)The public production store runs the current 0.9.5 tax contract with durable orders and signed-webhook reconciliation ready under a daily cap of 50. Checkout admissions are enabled, and public Sandbox evidence shows succeeded Custom API transactions. Exact durable-order and signed-webhook reconciliation remains pending before the lifecycle is accepted.Setup video (Public)Sanitized Test-mode public demo and local setup walkthrough for Node SDK and checkout drop-in 0.9.5; credentials, customer data, and payment details stay off camera.Written guide (Public)Node SDK 0.9.5 · checkout drop-in 0.9.5 · API v1Payments demo operationsUnique durable-order and signed-webhook reconciliation for the existing Sandbox evidence2026-08-25
Model Context Protocol/guides/mcpDemo (Public)Publicly available. No approval or admission request is required. Connect your client to https://mcp-sandbox.openborderpayments.com/mcp.Setup video (Not supported)No public setup video is published yet.Written guide (Public)Open Border MCP 0.1Open Border integrationsCompatible MCP client and Open Border Sandbox Test secret key2026-08-24
Salesforce B2C Commerce (SFRA)/guides/salesforceDemo (Blocked)Realm and Business Manager access remain the blocker.Setup video (Blocked)Realm and Business Manager access remain the blocker.Written guide (Public, unverified)Public immutable cartridge release 0.1.2 · SFRA 6.3+ · compatibility mode 22.7Salesforce integration ownerSalesforce realm, storefront, webhook correlation, and walkthrough2026-08-19

Support

Check service status first

Bookmark the public status page. Check current platform availability before opening a support request.

View system status