High Wire Payments

Errors & conventions

  • Base URLs: see Environments for the staging and production hosts.
  • Format: JSON request and response bodies; Content-Type: application/json.
  • Amounts: integer minor units where the reference says so — check each field's schema.
  • HTTP status codes: 2xx success · 400 invalid input · 401 bad/missing credentials · 404 not found · 409 conflict (e.g. already captured) · 422 unprocessable (declined).
  • Idempotency & retries: send an Idempotency-Key on payment requests; for calls that don't accept one, re-check with a GET before retrying.

Idempotency key

Previous Page

Authorize a payment POST

Authorizes the requested amount and leaves the payment in the AUTHORIZED state for later capture or void. The request can optionally save the payment method for future use.