Refund Payment

Initiate a refund of a payment back to the buyer. Refunds are always for the full payment amount. Partial refunds are not supported.

The same eligibility rules as the Finexio self-service portal apply: the payment must not be complete, must have no correction already in progress, and must not be flagged for fraud review. Check payments are eligible; card payments are eligible only while the card is unused (no purchase or authorization has occurred and the card still holds its full balance). ACH, wire, and international payments are not eligible for self-service correction — contact Finexio support to correct these.

This endpoint is safe to retry. If a correction is already in progress for the payment — whether created by an earlier API call, the Finexio portal, or Finexio operations — no second correction is created and no error is returned; instead the response is 200 OK with already_in_progress: true and the existing correction's current state.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params
number
required

Must equal the full original payment amount (the amount returned by GET /payments/{key}/). Any other value is rejected. Partial refunds are not supported.

string
enum
required

Why the refund is being requested. 'requested_by_customer' is currently the only accepted refund reason.

Allowed:
string

Optional free-text comment stored with the correction, visible to Finexio operations.

Responses

403

Forbidden. Your credential lacks the required permission.

500

Internal Server Error. The correction could not be initiated due to a transient fault and nothing was created. Safe to retry.

Language
Credentials
Basic
base64
:
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json