---
isPublished: true
knowledgeIndex: false
hidden: true
noindex: true
template: "page.peb"
title: "Stripe Charge Flow Action"
description: "Request a payment charge and return the charge result."
contentType: "reference"
audience: "admin,developer"
---

# Stripe Charge

Request a payment charge and return the charge result.
The namespaced Apex action name is `rooms__StripeChargeAction`.
Check action availability and input fields in your installed package.

## Transaction summary

| Effect | Behavior |
| --- | --- |
| API callout | Yes. The action waits for the charge API response. |
| Record writes | No direct record DML is performed by the action. The payment request can create or update charge-related records and external payment state. |
| Queued work | No background job is explicitly submitted by the action. |
| Email | A Receipt Email value can request a payment-provider receipt. This action does not send native Salesforce email. |

This is a payment action. Run it only as part of the approved payment process.
Stripe Live Mode defaults to false. Confirm the intended test or live payment configuration.
Amount is converted by multiplying by 100 before submission. Use amounts and currencies compatible with that conversion.
Payment Method ID is a required Flow input. It is a Salesforce payment-method record ID.
An unsuccessful or unreadable response can follow a completed charge. Check the existing payment before any retry.

## Inputs

**Required** describes the Flow input setting. The processing rules above also apply.

| API name | Flow label | Required | Default or guidance |
| --- | --- | --- | --- |
| `chargeId` | Charge record | No | Optional Salesforce charge record reference. |
| `id` | Stripe Charge ID | No | Optional Stripe charge reference for the approved process. |
| `currencyAmount` | Amount | Yes | Amount in currency units. The action multiplies it by 100 for submission. |
| `currencyType` | Currency Type | Yes | Configured payment currency. |
| `customer` | Stripe Customer ID | No | Optional configured Stripe customer ID. |
| `receipt_email` | Receipt Email | No | Optional address for the payment-provider receipt. |
| `liveMode` | Stripe Live Mode (Determines test or live charge) | No | Default: `false` for test mode. Set true only for the approved live payment process. |
| `description` | Description | No | Optional payment description. |
| `source` | Source | No | Optional configured payment source. Some source types also require the Stripe customer. |
| `roomId` | Room ID | No | Optional related Room reference. |
| `memberId` | Room Member ID | No | Optional related Room Member reference. |
| `itemId` | Room Item ID | No | Optional related Room Item reference. |
| `contactId` | Contact ID | No | Optional related Contact reference. |
| `accountId` | Account ID | No | Optional related Account reference. |
| `paymentMethodId` | Payment Method ID | Yes | Required Salesforce payment-method record ID. |
| `origin` | Origin | No | Optional originating-process value. |
| `metadata` | Custom Metadata (Format: name=value,name2=value2) | No | Optional comma-separated values in `name=value,name2=value2` form. |

## Outputs

| API name | Flow label | Meaning |
| --- | --- | --- |
| `success` | Success | Whether the payment request reported success. Confirm the returned charge identifiers. |
| `message` | Error message | Payment result or error details. |
| `id` | Stripe Charge ID | Stripe charge identifier when returned. |
| `recordId` | Salesforce Charge Record ID | Salesforce charge record identifier when returned. |

## Configure the Flow

1. Select the approved payment method and confirm amount, currency and mode.
2. Set the related records and receipt details that the payment process requires.
3. Store Success, Error message and both charge identifiers.
4. Continue only after the charge result is confirmed. Do not repeat an uncertain charge automatically.

Review the Flow context, Apex action access and the object and field permissions needed by this operation.
Record writes can run other Salesforce automation.

## Troubleshooting

**Payment method or customer is missing.** Supply the required payment-method record and the configured customer as needed.

**Amount or currency is rejected.** Verify the amount units, supported currency and payment configuration.

**The result is uncertain.** Check the existing Stripe charge and Salesforce charge record before another request.

**Uncommitted work pending.** This action makes a callout. Review earlier writes, email, events and queued work in the transaction.

See the [Flow action index](/content/build/flows/index.md) for transaction guidance and related actions.
