Refund
June 5, 2026 ยท View on GitHub
The refund information.
Structure
Refund
Fields
| Name | Type | Tags | Description | Getter | Setter |
|---|---|---|---|---|---|
Status | RefundStatus | Optional, Read-only | The status of the refund. | RefundStatus getStatus() | setStatus(RefundStatus status) |
StatusDetails | RefundStatusDetails | Optional | The details of the refund status. | RefundStatusDetails getStatusDetails() | setStatusDetails(RefundStatusDetails statusDetails) |
Id | String | Optional, Read-only | The PayPal-generated ID for the refund. | String getId() | setId(String id) |
Amount | Money | Optional | The currency and amount for a financial transaction, such as a balance or payment due. | Money getAmount() | setAmount(Money amount) |
InvoiceId | String | Optional, Read-only | The API caller-provided external invoice number for this order. Appears in both the payer's transaction history and the emails that the payer receives. | String getInvoiceId() | setInvoiceId(String invoiceId) |
CustomId | String | Optional | The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports. Constraints: Minimum Length: 1, Maximum Length: 255, Pattern: ^[A-Za-z0-9-_.,]*$ | String getCustomId() | setCustomId(String customId) |
AcquirerReferenceNumber | String | Optional | Reference ID issued for the card transaction. This ID can be used to track the transaction across processors, card brands and issuing banks. Constraints: Minimum Length: 1, Maximum Length: 36, Pattern: ^[a-zA-Z0-9]+$ | String getAcquirerReferenceNumber() | setAcquirerReferenceNumber(String acquirerReferenceNumber) |
NoteToPayer | String | Optional, Read-only | The reason for the refund. Appears in both the payer's transaction history and the emails that the payer receives. | String getNoteToPayer() | setNoteToPayer(String noteToPayer) |
SellerPayableBreakdown | SellerPayableBreakdown | Optional, Read-only | The breakdown of the refund. | SellerPayableBreakdown getSellerPayableBreakdown() | setSellerPayableBreakdown(SellerPayableBreakdown sellerPayableBreakdown) |
Payer | PayeeBase | Optional | The details for the merchant who receives the funds and fulfills the order. The merchant is also known as the payee. | PayeeBase getPayer() | setPayer(PayeeBase payer) |
Links | List<LinkDescription> | Optional, Read-only | An array of related HATEOAS links. | List | setLinks(List |
CreateTime | String | Optional | The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional. Note: The regular expression provides guidance but does not reject all invalid dates. Constraints: Minimum Length: 20, Maximum Length: 64, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$ | String getCreateTime() | setCreateTime(String createTime) |
UpdateTime | String | Optional | The date and time, in Internet date and time format. Seconds are required while fractional seconds are optional. Note: The regular expression provides guidance but does not reject all invalid dates. Constraints: Minimum Length: 20, Maximum Length: 64, Pattern: ^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$ | String getUpdateTime() | setUpdateTime(String updateTime) |
Example (as JSON)
{
"status": "CANCELLED",
"status_details": {
"reason": "ECHECK"
},
"id": "id6",
"amount": {
"currency_code": "currency_code6",
"value": "value0"
},
"invoice_id": "invoice_id6"
}