Rmfg Pay Cart
Block that pays an RMFG cart through the API. This charges a real card and starts production, so the platform marks it as a sensitive action that a person approves before it runs.
RMFG Pay Cart
What it is
Pays an RMFG cart with the saved card and places a real production order
How it works
Posts to /v1/carts/{id}/pay with card_on_file, which uses the card saved on the RMFG account page, or with payment_method and a Stripe PaymentMethod id you manage; the block refuses payment_method without a payment_method_id before any request is made. A connected RMFG account must have been approved with "Also allow paid orders" (the payments permission); an API key pays whenever the account has a saved card. RMFG only accepts an open cart whose quote is ready with a ship_to and shipping_option_id; anything else, a missing card, or a declined charge is reported as RMFG <code>: <message> on error and nothing is charged.
The charge is the cart's totals.amount_total_cents. A stable Idempotency-Key (defaulting to the node execution ID) makes retries safe: repeating a paid cart returns the existing payment rather than charging twice. A 202 means the outcome is not yet known, so payment_status is processing and checked_out is false; re-read the cart instead of paying again. On success the cart becomes checked_out and order_id points at the new order. The platform marks this block as a sensitive action, so a person approves each run.
Inputs
cart_id
Open cart whose quote is ready and which has a ship_to and shipping option. Its totals.amount_total_cents will be charged.
str
Yes
payment_type
card_on_file charges the card saved on the RMFG account page; payment_method charges a Stripe PaymentMethod you manage.
"card_on_file" | "payment_method"
No
payment_method_id
Stripe PaymentMethod id (pm_...) when payment_type is payment_method.
str
No
customer_email
Receipt and order emails; defaults to the account email.
str
No
customer_phone
Contact number for the order.
str
No
idempotency_key
Stable key so a retry never charges twice; defaults to the node execution ID. Use a new key only for a different purchase.
str
No
Outputs
error
Error message if the request failed
str
cart
The full cart, including its latest quote
Cart
cart_id
Cart ID
str
cart_url
Website checkout link; anyone holding it can pay, keep it private
str
status
open, checked_out or expired
"open" | "checked_out" | "expired"
quote_status
Status of the cart's latest quote; only ready carts can be paid
"processing" | "requires_input" | "ready" | "blocked" | "expired" | "failed"
is_payable
True when the cart is open, quoted ready, and has an address and shipping option
bool
totals
Subtotal, shipping, tax and total
CartTotals
amount_total_cents
What checkout will charge, in USD cents
int
shipping_options
Delivery choices once ship_to is set; pass an id to Update Cart
List[ShippingOption]
requirements
Selections or decisions still needed before ordering
List[Requirement]
manufacturing_warnings
Advisories from automatic file preparation; they do not block ordering
List[ManufacturingReviewWarning]
order_id
Order ID; only emitted once the cart has been paid
str
payment_status
paid, processing (check the cart again later), failed or refunded
"paid" | "processing" | "failed" | "refunded"
checked_out
True once the order exists
bool
Possible use case
Approved Agent Order: After the customer confirms the total, pay the cart and hand order_id to Get Order for tracking.
Automated Reorder: Re-order a standard part from a saved configuration with the account's card on file.
Managed Payment Method: Pay with a specific Stripe PaymentMethod when the business keeps its own cards.
Last updated
Was this helpful?