Credit Reversals
You can reverse some ReceivedCredits depending on their network and source flow. Reversing a ReceivedCredit leads to the creation of a new object known as a CreditReversal.
The CreditReversal object
Attributes
- idstring
Unique identifier for the object.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- amountinteger
Amount (in cents) transferred.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- financial_
accountstring The FinancialAccount to reverse funds from.
- hosted_
regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- networkenum
The rails used to reverse the funds.
- received_
creditstring The ReceivedCredit being reversed.
- statusenum
Status of the CreditReversal
- status_
transitionsobject Hash containing timestamps of when the object transitioned to a particular
status
. - transactionnullable stringExpandable
The Transaction associated with this object.
Create a CreditReversal
Reverses a ReceivedCredit and creates a CreditReversal object.
Parameters
- received_
creditstringRequired The ReceivedCredit to reverse.
- metadataobject
Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to
metadata
.
Returns
Returns a CreditReversal object.
Retrieve a CreditReversal
Retrieves the details of an existing CreditReversal by passing the unique CreditReversal ID from either the CreditReversal creation request or CreditReversal list
Parameters
No parameters.
Returns
Returns a CreditReversal object.
List all CreditReversals
Returns a list of CreditReversals.
Parameters
- financial_
accountstringRequired Returns objects associated with this FinancialAccount.
- received_
creditstring Only return CreditReversals for the ReceivedCredit ID.
- statusenum
Only return CreditReversals for a given status.
More parameters
- ending_
beforestring - limitinteger
- starting_
afterstring
Returns
A dictionary with a data
property that contains an array of up to limit
CreditReversals, starting after CreditReversal starting_after
. Each entry in the array is a separate CreditReversal object. If no more CreditReversal are available, the resulting array will be empty.