Refund

June 5, 2026 ยท View on GitHub

The refund information.

Structure

Refund

Fields

NameTypeTagsDescriptionGetterSetter
StatusRefundStatusOptional, Read-onlyThe status of the refund.RefundStatus getStatus()setStatus(RefundStatus status)
StatusDetailsRefundStatusDetailsOptionalThe details of the refund status.RefundStatusDetails getStatusDetails()setStatusDetails(RefundStatusDetails statusDetails)
IdStringOptional, Read-onlyThe PayPal-generated ID for the refund.String getId()setId(String id)
AmountMoneyOptionalThe currency and amount for a financial transaction, such as a balance or payment due.Money getAmount()setAmount(Money amount)
InvoiceIdStringOptional, Read-onlyThe 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)
CustomIdStringOptionalThe 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)
AcquirerReferenceNumberStringOptionalReference 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)
NoteToPayerStringOptional, Read-onlyThe reason for the refund. Appears in both the payer's transaction history and the emails that the payer receives.String getNoteToPayer()setNoteToPayer(String noteToPayer)
SellerPayableBreakdownSellerPayableBreakdownOptional, Read-onlyThe breakdown of the refund.SellerPayableBreakdown getSellerPayableBreakdown()setSellerPayableBreakdown(SellerPayableBreakdown sellerPayableBreakdown)
PayerPayeeBaseOptionalThe 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)
LinksList<LinkDescription>Optional, Read-onlyAn array of related HATEOAS links.List getLinks()setLinks(List links)
CreateTimeStringOptionalThe 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)
UpdateTimeStringOptionalThe 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"
}