Skip to main content
POST
Refund a charge
Refunds a cleared charge. As on a live card, the refund arrives as a new transaction with a negative amount, so your code has to handle one.

Authorizations

Authorization
string
header
required

A platform access token. Get one on the Create an access token endpoint by exchanging your client_id + client_secret, then send it as Authorization: Bearer <token>. Tokens live one hour.

Path Parameters

card_id
string
required
transaction_id
string
required

Body

application/json
amount_cents
integer

Defaults to the full charge.

Required range: x >= 1

Response

The new refund transaction.

object
string
required
Allowed value: "test_transaction"
id
string
required
card_id
string
required
amount_cents
integer
required

Negative on a refund.

merchant
string
required
status
enum<string>
required
Available options:
authorized,
cleared,
declined,
voided,
refunded
simulated
boolean
required
events
string[]
required

The webhook events this call sent.

card
object
required
mcc
string
decline_reason
string
original_transaction_id
string

On a refund, the transaction it refunds.