Flow Overview
You can charge a card in two ways:| Flow | When to use | Steps |
|---|---|---|
| Sale | You know the amount and want to charge now (e.g. e‑commerce) | One request; Revolv3 authorizes and captures in a single step. |
| Auth / Capture | You need to hold funds first and charge later (e.g. hotel, restaurant) | 1) Authorize to hold funds. 2) Capture (same or different amount) when ready. |
Sequence: Sale (One-Step Charge)
When to use: Checkout when the amount is known and you want to charge immediately. See Step-by-step “Make a Payment” example for a full request/response example.Sequence: Authorization Then Capture
When to use: When the final amount is unknown at auth time (e.g. hotel, restaurant, pre‑order). See Payment Authorizations & Captures for endpoints, sample requests, and responses.Sample Sale Request (summary)
Use your environment base URL (e.g.https://api-sandbox.revolv3.com for sandbox) as the API root.
- Endpoint:
POST /api/payments/sale - Body:
PaymentMethod(e.g.CreditCard+BillingAddress),Invoice(e.g.Amount,MerchantInvoiceRefId), optionalCustomerId, optionalNetworkProcessing.
Sample Auth Request (summary)
- Endpoint:
POST /api/payments/authorization - Body: Same shape as sale (amount, card, billing). Revolv3 holds funds and returns an authorization ID. You then call Capture or Void before the auth expires.
Where to Go Next
- Make a Payment — Full sale example and field descriptions
- Payment Authorizations & Captures — Auth/capture flow, samples, and voids