Introduction

How payments work

A paid request combines two jobs: paying for a service and receiving what you purchased. MPP and x402 carry the payment information alongside the HTTP request. InFlow processes supported payments; the seller’s application supplies the result.

Who does what

The buyer requests the service, selects an accepted payment option, and authorizes payment.

The seller sets the price and accepted options, checks the payment through its integration, and supplies the purchased result.

InFlow processes supported payments and applies spending controls when the buyer uses an InFlow account.

In x402, a facilitator is the service the seller calls to verify and settle a payment. InFlow fills that role. Settlement is the payment-processing step that transfers or charges the funds, depending on the selected payment option.

Understand the payment option

MPP and x402 describe how applications exchange payment information. The selected payment option determines how the purchase is paid.

TermMeaning and example
ProtocolThe payment-message format: MPP or x402.
MPP method and intentThe payment integration and requested operation—for example, inflow with charge.
InFlow payment railWithin the MPP inflow method, balance uses an InFlow balance; instrument uses a linked funding instrument.
x402 schemeThe payment rules selected by the offer—for example, exact, balance, or instrument.
Funding sourceThe balance, linked instrument, or wallet that funds the payment.

An MPP inflow charge using the balance rail and an x402 balance payment both use an InFlow balance. They express the purchase through different protocols.

Supporting the same protocol does not guarantee compatibility with every payment option. The buyer must support an option the seller actually offers. See Choose payment options for how to select a compatible option.

When approval is needed

InFlow checks the applicable spending rules for an InFlow-managed payment. An applicable approval policy can permit spending without a new manual approval. Otherwise, the request can require owner review or be declined by policy. See Policies for configuring these rules.

Approval permits spending; it does not mean the payment or delivery has finished. See Approvals and allowances for how to control this spending.

Buyers using external wallets follow their wallet’s authorization process instead. Accepting payments through InFlow does not require every buyer to use an InFlow account.

Confirm payment and delivery

Track the payment and the purchased result separately:

  • Payment prepared: the buyer has the credential or payload needed to proceed.
  • Payment successful: payment processing reports success.
  • Result received: the buyer receives the purchased report, download, or other response.

A timeout does not tell you whether payment succeeded. Keep the original payment identifiers and check the outcome before starting another payment. Follow Status and recovery when the outcome is uncertain.

If payment succeeded but the report was not delivered, investigate delivery separately rather than treating the payment as declined. Sellers should follow Deliver paid results to handle that application-side work.

Start building

Set up your account and API key using Accounts and environments, then follow the quickstart for your application.

Accept a payment

Configure a paid endpoint and verify that a buyer can pay for its result.

Make a payment

Call a paid service from your application and confirm payment and delivery.