{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Dime Bridge — split payments","projectTitle":"Dime Docs","description":"Split one customer payment across several merchants and keep a platform fee from each.","siteUrl":"https://docs.dimepay.net","lang":"en"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"dime-bridge","__idx":0},"children":["Dime Bridge"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dime Bridge splits one customer payment across several merchants in your"," ","marketplace, and lets you keep a platform fee from each of them. The buyer"," ","pays once. Dime works out each merchant's share from the items they sold,"," ","takes off processing fees and your fee, and pays each merchant the rest."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use Bridge whenever a single checkout includes items from more than one"," ","seller."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"capabilities","__idx":1},"children":["Capabilities"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["One payment, many merchants."]}," A single checkout pays several child"," ","merchants at once."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payouts worked out for you."]}," You don't calculate or send payout amounts."," ","Dime derives each merchant's share from the line items tagged with it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A platform fee per merchant."]}," You set the fee you keep from each"," ","merchant's payout, in major units (for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10"]}," = 10.00)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Works on every way of taking a payment:"]}," hosted checkout orders"," ","(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /orders"]},"), the hosted payment page (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payments/hosted-page"]},"),"," ","direct charges (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payments/sale"]},") and authorisations"," ","(",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payments/auth"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A full breakdown on every payment."]}," Payment webhooks include each"," ","merchant's gross, fee and net amount, so you can reconcile in your system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Single-merchant carts work too."]}," With one merchant, Bridge behaves like a"," ","normal payment with one platform fee."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":2},"children":["Before you start"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Bridge must be enabled on your account."]}," Ask Dime support. Until it is,"," ","any request containing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}," is rejected with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Not available on the bank processor model."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You need each child merchant's token"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["m…"]},"). Your own merchant is never"," ","a row in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]},": what you keep is expressed as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":3},"children":["How it works"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["You send"]}," a normal order or charge, plus two things:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].merchant_id"]},": which merchant sells each line item."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split[]"]},": one row per merchant, with its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant_id"]}," and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee"]}," you"," ","keep from it."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dime checks"]}," that every item is tagged, that every merchant in the items"," ","has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}," row (and the other way round), and that the items add up to"," ","the total."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When the buyer pays"]},", for each merchant Dime:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["adds up the merchant's items to get its ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["gross"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["deducts the merchant's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["processing fees"]}," from that gross,"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["deducts your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["platform fee"]},","]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["credits the remainder (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["net"]},") to the merchant's balance."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You keep the platform fees."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Webhooks"]}," deliver the per-merchant breakdown."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example","__idx":4},"children":["Example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A 2,000.00 USD order with two merchants:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Merchant"},"children":["Merchant"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Items"},"children":["Items"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Gross"},"children":["Gross"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Your fee"},"children":["Your fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Merchant receives"},"children":["Merchant receives"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["m4D8mQ1wMrdTUIg"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hardcover Book (500.00)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500.00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10.00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500.00 − processing fees − 10.00"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["m7UarSiV9zWxN6v"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Online Course (1,500.00)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1,500.00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["30.00"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1,500.00 − processing fees − 30.00"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Processing fees depend on each merchant's rates, so they aren't shown as"," ","fixed numbers here. The actual amounts arrive in the payment webhook."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"usage","__idx":5},"children":["Usage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All requests use your client key in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_key"]}," header. Examples target"," ","sandbox: swap the host for production when you go live."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://sandbox.api.dimepay.app/dapi/v2\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-bridge-order-hosted-checkout","__idx":6},"children":["Create a Bridge order (hosted checkout)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl https://sandbox.api.dimepay.app/dapi/v2/orders \\\n  -H \"client_key: ck_your_sandbox_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"id\": \"ORDER-10001\",\n    \"currency\": \"USD\",\n    \"subtotal\": 2000,\n    \"tax\": 0,\n    \"total\": 2000,\n    \"email\": \"buyer@example.com\",\n    \"items\": [\n      { \"id\": \"SKU-BOOK-1\",   \"name\": \"Hardcover Book\",       \"price\": 500,  \"quantity\": 1, \"merchant_id\": \"m4D8mQ1wMrdTUIg\" },\n      { \"id\": \"SKU-COURSE-1\", \"name\": \"Online Course Access\", \"price\": 1500, \"quantity\": 1, \"merchant_id\": \"m7UarSiV9zWxN6v\" }\n    ],\n    \"split\": [\n      { \"merchant_id\": \"m4D8mQ1wMrdTUIg\", \"fee\": 10 },\n      { \"merchant_id\": \"m7UarSiV9zWxN6v\", \"fee\": 30 }\n    ]\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes the order's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout_url"]},". Send the buyer there to pay."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"charge-a-saved-card-with-a-split","__idx":7},"children":["Charge a saved card with a split"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payments/sale"]}," (or"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payments/auth"]},"), along with the saved card's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"token\": \"card_Xk3m9QpL2vR7tYw\",\n  \"id\": \"9d2b7c54-1e8f-4a36-b7c1-5f0e2d8a4c13\",\n  \"currency\": \"USD\",\n  \"subtotal\": 2000,\n  \"tax\": 0,\n  \"total\": 2000,\n  \"email\": \"buyer@example.com\",\n  \"ipAddress\": \"198.51.100.10\",\n  \"referenceTransactionId\": \"sale-10001\",\n  \"items\": [\n    { \"id\": \"SKU-BOOK-1\",   \"name\": \"Hardcover Book\",       \"price\": 500,  \"quantity\": 1, \"merchant_id\": \"m4D8mQ1wMrdTUIg\" },\n    { \"id\": \"SKU-COURSE-1\", \"name\": \"Online Course Access\", \"price\": 1500, \"quantity\": 1, \"merchant_id\": \"m7UarSiV9zWxN6v\" }\n  ],\n  \"split\": [\n    { \"merchant_id\": \"m4D8mQ1wMrdTUIg\", \"fee\": 10 },\n    { \"merchant_id\": \"m7UarSiV9zWxN6v\", \"fee\": 30 }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"build-split-from-your-cart-nodejs","__idx":8},"children":["Build ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}," from your cart (Node.js)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"// Group the cart by merchant and attach your fee for each one.\nfunction buildSplit(items, feeByMerchant) {\n  const merchants = [...new Set(items.map((item) => item.merchant_id))];\n  return merchants.map((merchant_id) => ({\n    merchant_id,\n    fee: feeByMerchant[merchant_id] ?? 0,\n  }));\n}\n\nconst items = [\n  { id: 'SKU-BOOK-1',   name: 'Hardcover Book',       price: 500,  quantity: 1, merchant_id: 'm4D8mQ1wMrdTUIg' },\n  { id: 'SKU-COURSE-1', name: 'Online Course Access', price: 1500, quantity: 1, merchant_id: 'm7UarSiV9zWxN6v' },\n];\nconst total = items.reduce((sum, item) => sum + item.price * item.quantity, 0);\n\nconst order = {\n  id: 'ORDER-10001',\n  currency: 'USD',\n  subtotal: total,\n  tax: 0,\n  total,\n  email: 'buyer@example.com',\n  items,\n  split: buildSplit(items, { m4D8mQ1wMrdTUIg: 10, m7UarSiV9zWxN6v: 30 }),\n};\n\nconst res = await fetch('https://sandbox.api.dimepay.app/dapi/v2/orders', {\n  method: 'POST',\n  headers: { client_key: process.env.DIME_CLIENT_KEY, 'Content-Type': 'application/json' },\n  body: JSON.stringify(order),\n});\nconsole.log((await res.json()).checkout_url);\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rules","__idx":9},"children":["Rules"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Rule"},"children":["Rule"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What happens if it's broken"},"children":["What happens if it's broken"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Every line item has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant_id"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},": \"Bridge split orders require item-level merchant_id…\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Every merchant in the items has a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}," row, every ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}," row matches at least one item, and there are no duplicate rows."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Every ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant_id"]}," is a real Dime merchant, and not your own."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},": \"split contains an invalid Dime merchant token…\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].price × quantity"]}," adds up to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]},", to the cent."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},": \"Order line totals must equal the transaction charge…\""]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A merchant's payout can't go below zero after processing fees and your fee."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bridge is enabled on your account."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]},": \"Bridge split settlements are not enabled for this merchant…\""]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee"]}," is in major units, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," or more."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Don't send a payout amount (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split[].amount"]},"). Dime always derives it from"," ","the items."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Amounts are rounded down to two decimal places."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhooks-and-reconciliation","__idx":10},"children":["Webhooks and reconciliation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payment events (for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment.succeeded"]},") include the breakdown on"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payload.transaction.split[]"]},". Each row has:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The child merchant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gross_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total of that merchant's items."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The platform fee you kept."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["net_amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["What the merchant was credited after processing fees and your fee."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The transaction also carries ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settlement_override"]}," and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata.fee_breakdown"]},", which list the processing fees applied."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"refunds","__idx":11},"children":["Refunds"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A Bridge payment is refunded in full, once."]}," One refund reverses the"," ","payment for every merchant in the split."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Partial refunds aren't supported."]}," Don't send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," when refunding a"," ","Bridge payment: the whole payment is refunded either way."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once a Bridge payment has been refunded, any further refund on it returns"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409"]}," (\"One or more transactions have already been refunded\")."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"resources","__idx":12},"children":["Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v2/orders"},"children":["Orders"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /orders"]}," and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["split"]}," and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items[].merchant_id"]}," fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v2/payments"},"children":["Payments"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /payments/sale"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/auth"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/hosted-page"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/refund"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v2/transactions"},"children":["Transactions"]},": look up a Bridge payment and its"," ","split."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v2/dime-v2"},"children":["API v2 overview"]},": webhooks, authentication and errors."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/appendix/test-cards"},"children":["Test cards"]},": cards for trying Bridge in"," ","sandbox."]}]}]},"headings":[{"value":"Dime Bridge","id":"dime-bridge","depth":1},{"value":"Capabilities","id":"capabilities","depth":2},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Example","id":"example","depth":3},{"value":"Usage","id":"usage","depth":2},{"value":"Create a Bridge order (hosted checkout)","id":"create-a-bridge-order-hosted-checkout","depth":3},{"value":"Charge a saved card with a split","id":"charge-a-saved-card-with-a-split","depth":3},{"value":"Build split from your cart (Node.js)","id":"build-split-from-your-cart-nodejs","depth":3},{"value":"Rules","id":"rules","depth":2},{"value":"Webhooks and reconciliation","id":"webhooks-and-reconciliation","depth":2},{"value":"Refunds","id":"refunds","depth":2},{"value":"Resources","id":"resources","depth":2}],"frontmatter":{"title":"Dime Bridge","seo":{"title":"Dime Bridge — split payments","description":"Split one customer payment across several merchants and keep a platform fee from each."}},"lastModified":"2026-11-02T22:27:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/dime-bridge","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}