POST
/
v1
/
businesses
/
{businessId}
/
invoices
/
refunds

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Content-Type
string

Content-Type must be set to application/json

Path Parameters

businessId
string
required

The UUID of the business to create a refund for.

Body

application/json
external_id
string

An external identifier for the refund transaction.

refunded_amount
integer

The amount of the refund in cents. This value must be positive.

completed_at
string

The time the refund was completed.

payments
object[]

Payments that have been made towards the balance of the refund.

allocations
object[]

Allocations that have been made towards the balance of the refund.

fee
integer | null

The fee associated with the refund in cents. This value must be positive.

method
enum<string>

The method used to refund the payment.

Available options:
CASH,
CHECK,
CREDIT_CARD,
ACH,
STORE_CREDIT,
OTHER
processor
string | null

The payment processor used to refund the payment.

invoice_id
string | null

The ID of the invoice to refund.

Response

200 - application/json

A refund represents a transaction that returns value to from a business to a customer. A specific payment can be refunded or a general refund can be applied to an invoice.

id
string

Unique identifier for the refund.

external_id
string

Unique ID of the refund in your system for linking purposes. Idempotency key.

refunded_amount
integer

Amount refunded to the customer in cents.

status
string

Status of the refund.

completed_at
string

Time when the refund was completed.

payments
object[]

Payments associated with this refund.

allocations
object[]

Allocations associated with this refund.