Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.
In development. Payment capabilities have no recorded evidence yet. Use sandbox credentials only. See maturity levels.
There are two ways to take money in 86d, and only one of them exists today.Third-party Payments means you bring your own processor. You hold the account, you sign their agreement, you pay their rates, and 86d charges you nothing per Checkout. Stripe, PayPal, Square, and Braintree each have a first-party Module.86d Payments is the service 86d is building, where 86d handles onboarding, cards, wallets, settlement, and disputes for you at one published rate. Merchants see 86d Payments, not an upstream processor brand. It is not available. The section at the bottom of this page explains what it will cost, so you can plan.Third-party Payments stays available after 86d Payments ships. Nobody gets moved off a processor they chose.
Before you configure anything
Make sure you can:
create and reset a provider test account
keep server secrets in the deployment environment, out of config.json
expose a temporary HTTPS endpoint for provider events
One provider at a time. There is no safe failover between processors: a refund has to go back through whoever took the money, so a second configured provider buys you nothing and costs you a class of bug that is painful to find.
Configure it
Stripe
PayPal
Square
Braintree
Variable
What it is
STRIPE_SECRET_KEY
Test API secret
STRIPE_WEBHOOK_SECRET
Test event-signing secret
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY
Browser publishable key
Register this endpoint in Stripe:
POST https://store_domain_here/api/stripe/webhook
Subscribe to the PaymentIntent success, failure, cancellation, and refund events your test exercises. The Stripe Module page has the package detail.
Variable
What it is
PAYPAL_CLIENT_ID
Sandbox client identifier
PAYPAL_CLIENT_SECRET
Sandbox client secret
PAYPAL_WEBHOOK_ID
Your configured webhook identifier
PAYPAL_SANDBOX
Set to "true" for sandbox
The Storefront also needs NEXT_PUBLIC_PAYPAL_CLIENT_ID to render the PayPal button.
POST https://store_domain_here/api/paypal/webhook
Subscribe to capture completion and denial. See the PayPal Module.
Variable
What it is
SQUARE_ACCESS_TOKEN
Sandbox access token
SQUARE_WEBHOOK_SIGNATURE_KEY
Event signature key
SQUARE_WEBHOOK_NOTIFICATION_URL
The URL you registered
The Storefront also uses the public Square application and location identifiers.
POST https://store_domain_here/api/braintree/webhook
Subscribe to the settlement events your test uses. See the Braintree Module.
Test the event boundary
Provider events are the part that breaks in production and looks fine in a demo. Run all six of these before you widen testing:
Send a valid test event. Confirm exactly one state change.
Send an event with a bad signature. Confirm it is rejected, not merely logged.
Send the valid event again. Confirm no duplicate effect.
Deliver events out of order. Confirm state cannot move backward.
Retry after an ambiguous write. Confirm the recovery is idempotent.
Refund something. Confirm the refund went back through the Connection that took the Payment.
A green sandbox happy path is not evidence. The failure paths are the evidence.
Check the whole purchase, not the charge
A provider Module on its own does not give you a trustworthy path from Checkout to an Order. Verify the server-owned amount, Inventory, tax, Shipping, the Payment outcome, Order creation, and retry behavior together, because that is how they fail: together.See How commerce records relate, Payments, and Checkout.
What 86d Payments will cost
86d Payments is a planned service. When it arrives, the fee on Launch and Premium will be:
5% of eligible merchandise subtotal, plus exactly $0.50 per paid Checkout.
That rate is all-in. It is your complete cost to accept the payment. No separate processor line reaches you, because upstream processing is paid out of the same fee.Eligible merchandise is your subtotal after product discounts and Loyalty redemption. Shipping, tax, tips, and any order fee you define are excluded from the calculation.Some specifics worth knowing before you model your margins:
One fee per paid Checkout, created when confirmed captures first cover the full amount due. An authorization on its own creates no fee.
Splitting a payment into several captures does not repeat the 50 cent charge.
A void, a full refund, a cancellation you make, or a chargeback the buyer wins credits the entire fee back to you.
A partial refund recalculates the fee against what is left. While merchandise remains, 86d keeps 5% of that remainder plus $0.50. When nothing eligible remains, no fee remains.
A reversed refund or dispute outcome reverses the matching adjustment.
Launch and Premium share one published rate with no volume tiers. Enterprise rates are negotiated. Using 86d Payments does not waive the 86d Cloud management fee.
86d is not the merchant of record, does not sell chargeback protection, and does not insure you against fraud loss. Refund, dispute, and chargeback costs stay yours unless 86d caused the failure.
Selling before payments are switched on
A Store waiting on payment activation can retain a non-binding Checkout Request for 30 days. It stores the requested Products, quantities, contact details, and displayed estimate. It stores no Payment credential, reserves no Inventory, guarantees no price, and creates no Payment or Order.If payments activate before the request expires, the Store may send one checkout invitation that expires no later than the request. Checkout recalculates price, Inventory, tax, and Shipping, then asks the Shopper to accept the fresh result and provide a Payment method. Payment finalization may hold Inventory for 15 minutes; success commits that lease, while cancellation, failure, or expiry releases it. The Store never collects a card for deferred capture before activation.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"86d","colors":{"primary":"#0086d0","light":"#00a9ff","dark":"#0071b8"},"logo":{"light":"https://86d.app/icon?w=48\u0026h=48","dark":"https://86d.app/icon?w=48\u0026h=48","href":"https://86d.app"},"favicon":"https://86d.app/icon/favicon.ico","background":{"color":{"light":"#fdfdfd","dark":"#010103"}},"navbar":{"primary":{"type":"github","href":"https://github.com/86d-store/86d"}},"footer":{"socials":{"github":"https://github.com/86d-store/86d","x":"https://x.com/86d_app","linkedin":"https://www.linkedin.com/company/86d"}},"fonts":{"heading":{"family":"Zalando Sans Expanded","weight":400,"source":"https://86d.app/fonts/webfonts/ZalandoSans-Expanded.woff2","format":"woff2"},"body":{"family":"Zalando Sans","weight":400,"source":"https://86d.app/fonts/webfonts/ZalandoSans-Regular.woff2","format":"woff2"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"86d","hasAudioNarration":false,"actualSubdomain":"86d","customDomains":["86d.store"],"gitSource":{"type":"github","owner":"86d-store","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ad736e93eabd17c662510d5","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Modules","count":102},{"language":"default","tag":"Documentation","count":40},{"language":"default","tag":"Operations","count":19},{"language":"default","tag":"Shopping","count":13},{"language":"default","tag":"Finance","count":13},{"language":"default","tag":"Marketing","count":12},{"language":"default","tag":"Sales channels","count":12},{"language":"default","tag":"Catalog","count":12},{"language":"default","tag":"Fulfillment","count":11},{"language":"default","tag":"Resources","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"fonts.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1iIq129k.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1isq129k.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1pUL8lJdhg.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1iAq129k.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1iEq129k.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F63fjptAgt5VM-kVkqdyU8n1i8q1w.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3vAOwl1FgtIU.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3vAOwlRFgtIU.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3vAOwupkp-8tFQ.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3vAOwl9FgtIU.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3vAOwl5FgtIU.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/ibmplexmono/v23/-F6qfjptAgt5VM-kVkqdyU8n3vAOwlBFgg.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 400;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSeqnJ-mFqA.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 400;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSequJ-mFqA.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 400;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSeqlJ-mFqA.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 400;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSeqkJ-mFqA.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 400;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSeqqJ-k.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 700;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSeqnJ-mFqA.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 700;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSequJ-mFqA.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 700;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSeqlJ-mFqA.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 700;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSeqkJ-mFqA.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Merriweather';\n font-style: normal;\n font-weight: 700;\n font-stretch: 100%;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/merriweather/v33/u-4e0qyriQwlOrhSvowK_l5UcA6zuSYEqOzpPe3HOZJ5eX1WtLaQwmYiSeqqJ-k.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--font-mono:\n\t\t\"IBM Plex Mono\", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,\n\t\t\"Liberation Mono\", \"Courier New\", monospace;--font-serif: \"Merriweather\", ui-serif, Georgia, \"Times New Roman\", serif}code,kbd,samp,pre,code-block{font-family:var(--font-mono)}blockquote{font-family:var(--font-serif)}"}],"page":{"pagePath":"guides/payment-integrations","slug":"/guides/payment-integrations","pageMetadata":{"title":"Set up a payment provider","description":"Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.","sidebarTitle":"Payment integrations","href":"/guides/payment-integrations"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tab,Table,Tabs,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`In development.`}),` Payment capabilities have no recorded evidence yet. Use sandbox credentials only. See `,_jsx(_components.a,{href:`/resources/versioning`,children:`maturity levels`}),`.`]})}),`\n`,_jsx(_components.p,{children:`There are two ways to take money in 86d, and only one of them exists today.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Third-party Payments`}),` means you bring your own processor. You hold the account, you sign their agreement, you pay their rates, and 86d charges you nothing per `,_jsx(_components.a,{href:`/modules/checkout`,children:`Checkout`}),`. Stripe, PayPal, Square, and Braintree each have a first-party `,_jsx(_components.a,{href:`/concepts/modules`,children:`Module`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.a,{href:`/resources/glossary#86d-payments`,children:`86d Payments`})}),` is the service 86d is building, where 86d handles onboarding, cards, wallets, settlement, and disputes for you at one published rate. Merchants see 86d Payments, not an upstream processor brand. It is not available. The section at the bottom of this page explains what it will cost, so you can plan.`]}),`\n`,_jsx(_components.p,{children:`Third-party Payments stays available after 86d Payments ships. Nobody gets moved off a processor they chose.`}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-configure-anything`,children:`Before you configure anything`}),`\n`,_jsx(_components.p,{children:`Make sure you can:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`create and reset a provider test account`}),`\n`,_jsxs(_components.li,{children:[`keep server secrets in the deployment environment, out of `,_jsx(_components.code,{children:`config.json`})]}),`\n`,_jsx(_components.li,{children:`expose a temporary HTTPS endpoint for provider events`}),`\n`,_jsx(_components.li,{children:`read the provider’s own event log`}),`\n`,_jsx(_components.li,{children:`throw away your Store’s test data afterward`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Read `,_jsx(_components.a,{href:`/concepts/connections`,children:`How Connections route provider work`}),` before you test a refund. Refunds are where provider routing stops being an abstraction.`]}),`\n`,_jsx(Heading,{level:`2`,id:`install-one-provider`,children:`Install one provider`}),`\n`,_jsxs(_components.p,{children:[`Install `,_jsx(_components.code,{children:`@86d-store/payments`}),` alongside exactly one provider Module:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @86d-store/payments`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` @86d-store/stripe`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Add both to your active `,_jsx(_components.a,{href:`/concepts/templates`,children:`Template`}),`’s `,_jsx(_components.code,{children:`config.json`}),` and regenerate:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"modules\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@86d-store/payments\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"@86d-store/stripe\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"advanced\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"allowExperimentalModules\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`86d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` generate`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`One provider at a time. There is no safe failover between processors: a refund has to go back through whoever took the money, so a second configured provider buys you nothing and costs you a class of bug that is painful to find.`})}),`\n`,_jsx(Heading,{level:`2`,id:`configure-it`,children:`Configure it`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Stripe`,id:`stripe`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`STRIPE_SECRET_KEY`})}),_jsx(_components.td,{children:`Test API secret`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`STRIPE_WEBHOOK_SECRET`})}),_jsx(_components.td,{children:`Test event-signing secret`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY`})}),_jsx(_components.td,{children:`Browser publishable key`})]})]})]}),_jsx(_components.p,{children:`Register this endpoint in Stripe:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST https://store_domain_here/api/stripe/webhook`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`Subscribe to the PaymentIntent success, failure, cancellation, and refund events your test exercises. The `,_jsx(_components.a,{href:`/modules/stripe`,children:`Stripe Module`}),` page has the package detail.`]})]}),_jsxs(Tab,{title:`PayPal`,id:`paypal`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PAYPAL_CLIENT_ID`})}),_jsx(_components.td,{children:`Sandbox client identifier`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PAYPAL_CLIENT_SECRET`})}),_jsx(_components.td,{children:`Sandbox client secret`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PAYPAL_WEBHOOK_ID`})}),_jsx(_components.td,{children:`Your configured webhook identifier`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`PAYPAL_SANDBOX`})}),_jsxs(_components.td,{children:[`Set to `,_jsx(_components.code,{children:`\"true\"`}),` for sandbox`]})]})]})]}),_jsxs(_components.p,{children:[`The `,_jsx(_components.a,{href:`/concepts/storefront`,children:`Storefront`}),` also needs `,_jsx(_components.code,{children:`NEXT_PUBLIC_PAYPAL_CLIENT_ID`}),` to render the PayPal button.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST https://store_domain_here/api/paypal/webhook`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`Subscribe to capture completion and denial. See the `,_jsx(_components.a,{href:`/modules/paypal`,children:`PayPal Module`}),`.`]})]}),_jsxs(Tab,{title:`Square`,id:`square`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SQUARE_ACCESS_TOKEN`})}),_jsx(_components.td,{children:`Sandbox access token`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SQUARE_WEBHOOK_SIGNATURE_KEY`})}),_jsx(_components.td,{children:`Event signature key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`SQUARE_WEBHOOK_NOTIFICATION_URL`})}),_jsx(_components.td,{children:`The URL you registered`})]})]})]}),_jsx(_components.p,{children:`The Storefront also uses the public Square application and location identifiers.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST https://store_domain_here/api/square/webhook`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/modules/square`,children:`Square Module`}),`.`]})]}),_jsxs(Tab,{title:`Braintree`,id:`braintree`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`BRAINTREE_MERCHANT_ID`})}),_jsx(_components.td,{children:`Sandbox merchant identifier`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`BRAINTREE_PUBLIC_KEY`})}),_jsx(_components.td,{children:`Sandbox public key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`BRAINTREE_PRIVATE_KEY`})}),_jsx(_components.td,{children:`Sandbox private key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`BRAINTREE_SANDBOX`})}),_jsxs(_components.td,{children:[`Set to `,_jsx(_components.code,{children:`\"true\"`}),` for sandbox`]})]})]})]}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST https://store_domain_here/api/braintree/webhook`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`Subscribe to the settlement events your test uses. See the `,_jsx(_components.a,{href:`/modules/braintree`,children:`Braintree Module`}),`.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`test-the-event-boundary`,children:`Test the event boundary`}),`\n`,_jsx(_components.p,{children:`Provider events are the part that breaks in production and looks fine in a demo. Run all six of these before you widen testing:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Send a valid test event. Confirm exactly one state change.`}),`\n`,_jsx(_components.li,{children:`Send an event with a bad signature. Confirm it is rejected, not merely logged.`}),`\n`,_jsx(_components.li,{children:`Send the valid event again. Confirm no duplicate effect.`}),`\n`,_jsx(_components.li,{children:`Deliver events out of order. Confirm state cannot move backward.`}),`\n`,_jsx(_components.li,{children:`Retry after an ambiguous write. Confirm the recovery is idempotent.`}),`\n`,_jsxs(_components.li,{children:[`Refund something. Confirm the refund went back through the `,_jsx(_components.a,{href:`/concepts/connections`,children:`Connection`}),` that took the `,_jsx(_components.a,{href:`/modules/payments`,children:`Payment`}),`.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`A green sandbox happy path is not evidence. The failure paths are the evidence.`}),`\n`,_jsx(Heading,{level:`2`,id:`check-the-whole-purchase-not-the-charge`,children:`Check the whole purchase, not the charge`}),`\n`,_jsxs(_components.p,{children:[`A provider Module on its own does not give you a trustworthy path from Checkout to an `,_jsx(_components.a,{href:`/modules/orders`,children:`Order`}),`. Verify the server-owned amount, `,_jsx(_components.a,{href:`/modules/inventory`,children:`Inventory`}),`, tax, `,_jsx(_components.a,{href:`/modules/shipping`,children:`Shipping`}),`, the Payment outcome, Order creation, and retry behavior together, because that is how they fail: together.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/commerce-model`,children:`How commerce records relate`}),`, `,_jsx(_components.a,{href:`/modules/payments`,children:`Payments`}),`, and `,_jsx(_components.a,{href:`/modules/checkout`,children:`Checkout`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-86d-payments-will-cost`,children:`What 86d Payments will cost`}),`\n`,_jsxs(_components.p,{children:[`86d Payments is a planned service. When it arrives, the fee on `,_jsx(_components.a,{href:`/resources/cloud-plans`,children:`Launch`}),` and Premium will be:`]}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`5% of eligible merchandise subtotal, plus exactly $0.50 per paid Checkout.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`That rate is `,_jsx(_components.strong,{children:`all-in`}),`. It is your complete cost to accept the payment. No separate processor line reaches you, because upstream processing is paid out of the same fee.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Eligible merchandise`}),` is your subtotal after product discounts and `,_jsx(_components.a,{href:`/modules/loyalty`,children:`Loyalty`}),` redemption. Shipping, tax, tips, and any order fee you define are excluded from the calculation.`]}),`\n`,_jsx(_components.p,{children:`Some specifics worth knowing before you model your margins:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`One fee per paid Checkout, created when confirmed captures first cover the full amount due. An authorization on its own creates no fee.`}),`\n`,_jsx(_components.li,{children:`Splitting a payment into several captures does not repeat the 50 cent charge.`}),`\n`,_jsx(_components.li,{children:`A void, a full refund, a cancellation you make, or a chargeback the buyer wins credits the entire fee back to you.`}),`\n`,_jsx(_components.li,{children:`A partial refund recalculates the fee against what is left. While merchandise remains, 86d keeps 5% of that remainder plus $0.50. When nothing eligible remains, no fee remains.`}),`\n`,_jsx(_components.li,{children:`A reversed refund or dispute outcome reverses the matching adjustment.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Launch and Premium share one published rate with no volume tiers. Enterprise rates are negotiated. Using 86d Payments does not waive the `,_jsx(_components.a,{href:`/resources/cloud-plans`,children:`86d Cloud`}),` management fee.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`86d is not the merchant of record, does not sell chargeback protection, and does not insure you against fraud loss. Refund, dispute, and chargeback costs stay yours unless 86d caused the failure.`})}),`\n`,_jsx(Heading,{level:`2`,id:`selling-before-payments-are-switched-on`,children:`Selling before payments are switched on`}),`\n`,_jsxs(_components.p,{children:[`A Store waiting on payment activation can retain a non-binding `,_jsx(_components.a,{href:`/resources/glossary#checkout-request`,children:`Checkout Request`}),` for 30 days. It stores the requested Products, quantities, contact details, and displayed estimate. It stores no Payment credential, reserves no Inventory, guarantees no price, and creates no Payment or Order.`]}),`\n`,_jsx(_components.p,{children:`If payments activate before the request expires, the Store may send one checkout invitation that expires no later than the request. Checkout recalculates price, Inventory, tax, and Shipping, then asks the Shopper to accept the fresh result and provide a Payment method. Payment finalization may hold Inventory for 15 minutes; success commits that lease, while cancellation, failure, or expiry releases it. The Store never collects a card for deferred capture before activation.`}),`\n`,_jsx(Heading,{level:`2`,id:`related-pages`,children:`Related pages`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/modules/payments`,children:`Payments`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/concepts/commerce-model`,children:`How commerce records relate`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/concepts/connections`,children:`How Connections route provider work`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/configuration/environment-variables`,children:`Environment variables`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/operations/security`,children:`Secure a Store Runtime`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/resources/cloud-plans`,children:`86d Cloud plans`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/resources/versioning`,children:`Versioning and maturity`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/resources/public-beta`,children:`Public Beta status`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Set up a payment provider","description":"Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.","sidebarTitle":"Payment integrations","href":"/guides/payment-integrations"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you configure anything","slug":"before-you-configure-anything","depth":2,"children":[]},{"title":"Install one provider","slug":"install-one-provider","depth":2,"children":[]},{"title":"Configure it","slug":"configure-it","depth":2,"children":[]},{"title":"Test the event boundary","slug":"test-the-event-boundary","depth":2,"children":[]},{"title":"Check the whole purchase, not the charge","slug":"check-the-whole-purchase-not-the-charge","depth":2,"children":[]},{"title":"What 86d Payments will cost","slug":"what-86d-payments-will-cost","depth":2,"children":[]},{"title":"Selling before payments are switched on","slug":"selling-before-payments-are-switched-on","depth":2,"children":[]},{"title":"Related pages","slug":"related-pages","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"86d","siteName":"86d","title":"Set up a payment provider - 86d","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-10T03:13:39.379Z","originalFileLocation":"guides/payment-integrations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.\">\u003cmeta data-mint-head name=\"application-name\" content=\"86d\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/x-icon\" sizes=\"180x180\" href=\"https://86d.app/icon/favicon.ico\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"32x32\" href=\"https://86d.app/icon/favicon.ico\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"16x16\" href=\"https://86d.app/icon/favicon.ico\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://86d.app/icon/favicon.ico\">\u003cmeta data-mint-head property=\"og:title\" content=\"Set up a payment provider - 86d\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"86d\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://86d.store/docs/guides/payment-integrations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://86d.mintlify.site/docs/_mintlify/api/og/v2?division=Guides\u0026amp;title=Set+up+a+payment+provider\u0026amp;description=Connect+your+own+Stripe%2C+PayPal%2C+Square%2C+or+Braintree+account+for+sandbox+testing%2C+and+understand+how+86d+Payments+will+differ+when+it+arrives.\u0026amp;theme=c01fa02ab7c3ea8124c39cdf\u0026amp;signature=83fef7ae6615abf340133fde495136ca809637fb1e17414d019625f5ecf8a808\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Set up a payment provider - 86d\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://86d.mintlify.site/docs/_mintlify/api/og/v2?division=Guides\u0026amp;title=Set+up+a+payment+provider\u0026amp;description=Connect+your+own+Stripe%2C+PayPal%2C+Square%2C+or+Braintree+account+for+sandbox+testing%2C+and+understand+how+86d+Payments+will+differ+when+it+arrives.\u0026amp;theme=c01fa02ab7c3ea8124c39cdf\u0026amp;signature=83fef7ae6615abf340133fde495136ca809637fb1e17414d019625f5ecf8a808\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/86d/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"86d\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0086d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://86d.store/docs/guides/payment-integrations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/guides/payment-integrations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://86d.store/#organization\",\"name\":\"86d\",\"url\":\"https://86d.store\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://86d.app/icon?w=48\u0026h=48\"}},{\"@type\":\"WebSite\",\"@id\":\"https://86d.store/docs#website\",\"name\":\"86d\",\"url\":\"https://86d.store/docs\",\"publisher\":{\"@id\":\"https://86d.store/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://86d.store/docs/guides/payment-integrations#webpage\",\"url\":\"https://86d.store/docs/guides/payment-integrations\",\"name\":\"Set up a payment provider\",\"description\":\"Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.\",\"dateModified\":\"2026-09-10T03:13:39.379Z\",\"isPartOf\":{\"@id\":\"https://86d.store/docs#website\"},\"breadcrumb\":{\"@id\":\"https://86d.store/docs/guides/payment-integrations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://86d.store/docs/guides/payment-integrations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Guides\",\"item\":\"https://86d.store/docs/guides/adding-modules\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Set up a payment provider\",\"item\":\"https://86d.store/docs/guides/payment-integrations\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://86d.store/docs/guides/payment-integrations#article\",\"headline\":\"Set up a payment provider\",\"name\":\"Set up a payment provider\",\"description\":\"Connect your own Stripe, PayPal, Square, or Braintree account for sandbox testing, and understand how 86d Payments will differ when it arrives.\",\"url\":\"https://86d.store/docs/guides/payment-integrations\",\"mainEntityOfPage\":{\"@id\":\"https://86d.store/docs/guides/payment-integrations#webpage\"},\"dateModified\":\"2026-09-10T03:13:39.379Z\",\"publisher\":{\"@id\":\"https://86d.store/#organization\"},\"isPartOf\":{\"@id\":\"https://86d.store/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"86d\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"86d\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/guides/payment-integrations.md","siteName":"86d","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"86d","sidebarTitle":"Home","href":""},{"title":"What is 86d?","href":"/introduction"},{"title":"Quickstart","href":"/quickstart"},{"title":"Deployment and hosting","href":"/deployment"}]},{"group":"Concepts","pages":[{"title":"How 86d separates product authority","sidebarTitle":"Architecture","href":"/concepts/architecture"},{"title":"How commerce records relate","sidebarTitle":"Commerce model","href":"/concepts/commerce-model"},{"title":"How Connections route provider work","sidebarTitle":"Provider Connections","href":"/concepts/connections"},{"title":"How Modules package Store capabilities","sidebarTitle":"Modules","href":"/concepts/modules"},{"title":"Templates","sidebarTitle":"Templates","href":"/concepts/templates"},{"title":"Storefront","href":"/concepts/storefront"},{"title":"Store Admin","href":"/concepts/admin"},{"title":"How agents work with 86d","sidebarTitle":"Agent operations","href":"/concepts/agentic-design"}]},{"group":"Configuration","pages":[{"title":"config.json reference","sidebarTitle":"config.json","href":"/configuration/store-config"},{"title":"Environment variables","href":"/configuration/environment-variables"},{"title":"Configure storage","href":"/configuration/storage"},{"title":"Authentication","href":"/configuration/authentication"}]},{"group":"Guides","pages":[{"title":"Add a Module","href":"/guides/adding-modules"},{"title":"Build a custom Module","href":"/guides/building-a-module"},{"title":"Customize a Template","description":"Change your Store's name, colors, logo, and page layouts by editing MDX files and config.json. No build tooling involved.","sidebarTitle":"Customize a Template","href":"/guides/customizing-templates"},{"title":"Set up a payment provider","sidebarTitle":"Payment integrations","href":"/guides/payment-integrations"},{"title":"Connect a sales channel","description":"Work out how much a channel actually commits you to, then test the operations that category demands before you rely on it.","sidebarTitle":"Channel integrations","href":"/guides/channel-integrations"},{"title":"Rehearse a Shopify migration","sidebarTitle":"Migrating from Shopify","href":"/guides/migrating-from-shopify"},{"title":"Connect an agent to 86d","sidebarTitle":"Agent connection","href":"/guides/agent-connection"}]},{"group":"CLI","pages":[{"title":"Use the 86d CLI","sidebarTitle":"CLI overview","href":"/cli/overview"},{"title":"CLI command reference","sidebarTitle":"Command reference","href":"/cli/commands"}]},{"group":"Operations","pages":[{"title":"Managed Workflows","sidebarTitle":"Managed Workflows","href":"/operations/managed-workflows"},{"title":"What launch evidence means","sidebarTitle":"Launch evidence","href":"/operations/launch-evidence"},{"title":"Secure a Store Runtime","sidebarTitle":"Security model","href":"/operations/security"},{"title":"Test the Store Runtime","sidebarTitle":"Testing","href":"/operations/testing"},{"title":"Watch a Store Runtime","sidebarTitle":"Observability","href":"/operations/observability"},{"title":"Troubleshooting","href":"/operations/troubleshooting"}]},{"group":"Resources","pages":[{"title":"Glossary","sidebarTitle":"Glossary","href":"/resources/glossary"},{"title":"Common questions","sidebarTitle":"FAQ","href":"/resources/faq"},{"title":"Public Beta status","sidebarTitle":"Public Beta status","href":"/resources/public-beta"},{"title":"86d Cloud plans","sidebarTitle":"86d Cloud plans","href":"/resources/cloud-plans"},{"title":"Versioning and maturity","href":"/resources/versioning"},{"title":"Contributing","href":"/resources/contributing"},{"title":"Changelog","href":"/resources/changelog"},{"title":"Agent skills","sidebarTitle":"Agent skills","href":"/resources/skills"},{"title":"Docs MCP server","href":"/resources/mcp"}]}]},{"tab":"Modules","pages":[{"title":"Modules","href":"/modules/overview"}]}]},"basePath":"","title":"Set up a payment provider - 86d","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":[],"chunks":[]}