Skip to content

Refund a committed payment intent, in whole or in part.

POST
/payments/card/{id}/refund

Refunds are aggregate-only: there is no per-refund object and no refund-enumeration endpoint. Only amount_refunded on the intent reflects the running total refunded; issue multiple calls for multiple partial refunds up to the captured amount.

id
required
string
Example
pi_9Z3K01ARZ3NDEKTSV4RRFFQ69G5FAV

Payment intent ID

object
amount
required

Amount to refund, in the currency’s minor units. Must not exceed the remaining refundable amount (amount_captured − amount_refunded).

integer format: int64
Example
1000

Refunded. The returned intent’s amount_refunded reflects the new aggregate total

object
amount
required

A monetary amount in the currency’s minor units (e.g. cents for USD).

integer format: int64
Example
1000
amount_captured
required

A monetary amount in the currency’s minor units (e.g. cents for USD).

integer format: int64
Example
1000
amount_refunded
required

A monetary amount in the currency’s minor units (e.g. cents for USD).

integer format: int64
Example
1000
capture_method
required
string
Allowed values: automatic manual
created
required
integer format: int64
currency
required

Currently supported currencies by Paygasus Pay

string
Allowed values: USD
Example
USD
description
string | null
id
required
string
Example
pi_9Z3K01ARZ3NDEKTSV4RRFFQ69G5FAV
livemode
required
boolean
metadata
required
object
key
additional properties
string
payment_method
One of:
null
statement_descriptor
string | null
status
required
One of:
object
status
required
string
Allowed values: created
updated
required
integer format: int64

No such payment intent

object
error
required
object
code
required
string
message
required
string
param
string | null
type
required
string

Intent is not in a refundable state, is already being processed, or the amount exceeds the refundable remaining

object
error
required
object
code
required
string
message
required
string
param
string | null
type
required
string

Processor transport failure; the operation is retryable

object
error
required
object
code
required
string
message
required
string
param
string | null
type
required
string