Payment Embed: Itemized Charges

​

Overview

1. Create a charge with line items and discounts using the Create Charge or Convert Cart to Charge API.
2. Build the embed URL with the charge ID.
3. Patient pays in the embed — the form displays the full charge breakdown (items, discounts, total).

​

Step 1: Create a charge with items

​

Option A: Convert a cart to a charge

1. Create a cart for the patient.
2. Add items (products, services, packages) to the cart.
3. Convert the cart to a charge.

​

Option B: Create a charge directly

• patient_id
• items — array of line items with name, quantity, price, and optional discounts
• total_outstanding — sum of item totals minus discounts

{
  "patient_id": "pat_xxx",
  "total_outstanding": 8500,
  "items": [
    {
      "name": "Consultation",
      "quantity": 1,
      "price": 10000,
      "discounts": [{ "amount": 1500, "order": 0, "quantity": 1 }]
    }
  ]
}

​

Step 2: Build the embed URL

https://app.decodahealth.com/{tenant}/embed/pay/{patientId}?charge_id={chargeId}

• {tenant} — your organization’s subdomain
• {patientId} — the patient’s ID (must match the charge’s patient)
• {chargeId} — the charge ID from step 1

​

Optional URL parameters

?charge_id=chg_xxx&allowedMethods=CARD&theme=dark

​

Step 3: Load the embed

<iframe
  src="https://app.decodahealth.com/your-tenant/embed/pay/pat_xxx?charge_id=chg_xxx&allowedMethods=CARD"
  width="100%"
  height="500"
  allow="payment"
  style="border: none; border-radius: 8px;"
></iframe>

window.addEventListener('message', function(event) {
  if (event.data.type === 'payment_success') {
    console.log('Payment successful:', event.data.payinId);
  } else if (event.data.type === 'payment_failure') {
    console.log('Payment failed:', event.data.error);
  } else if (event.data.type === 'payment_loaded') {
    console.log('Payment form loaded');
  }
});

​

API flow

1. Loads the charge from the database (with items and discounts).
2. Creates a Rainforest payin config for that charge.
3. Returns the session key and payin config ID.

​

Disabling payment methods

• allowedMethods=CARD — card only (no ACH, no Apple Pay)
• allowedMethods=CARD,APPLE_PAY — card and Apple Pay (no ACH)
• allowedMethods=CARD,ACH — card and ACH (no Apple Pay)