Captured Payment

June 5, 2026 ยท View on GitHub

A captured payment.

Structure

CapturedPayment

Fields

NameTypeTagsDescriptionGetterSetter
StatusCaptureStatusOptional, Read-onlyThe status of the captured payment.CaptureStatus getStatus()setStatus(CaptureStatus status)
StatusDetailsCaptureStatusDetailsOptionalThe details of the captured payment status.CaptureStatusDetails getStatusDetails()setStatusDetails(CaptureStatusDetails statusDetails)
IdStringOptional, Read-onlyThe PayPal-generated ID for the captured payment.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: Maximum Length: 255
String getCustomId()setCustomId(String customId)
NetworkTransactionReferenceNetworkTransactionOptionalReference values used by the card network to identify a transaction.NetworkTransaction getNetworkTransactionReference()setNetworkTransactionReference(NetworkTransaction networkTransactionReference)
SellerProtectionSellerProtectionOptionalThe level of protection offered as defined by PayPal Seller Protection for Merchants.SellerProtection getSellerProtection()setSellerProtection(SellerProtection sellerProtection)
FinalCaptureBooleanOptional, Read-onlyIndicates whether you can make additional captures against the authorized payment. Set to true if you do not intend to capture additional payments against the authorization. Set to false if you intend to capture additional payments against the authorization.

Default: false
Boolean getFinalCapture()setFinalCapture(Boolean finalCapture)
SellerReceivableBreakdownSellerReceivableBreakdownOptionalThe detailed breakdown of the capture activity. This is not available for transactions that are in pending state.SellerReceivableBreakdown getSellerReceivableBreakdown()setSellerReceivableBreakdown(SellerReceivableBreakdown sellerReceivableBreakdown)
DisbursementModeDisbursementModeOptionalThe funds that are held on behalf of the merchant.

Default: DisbursementMode.INSTANT

Constraints: Minimum Length: 1, Maximum Length: 16, Pattern: ^[A-Z_]+$
DisbursementMode getDisbursementMode()setDisbursementMode(DisbursementMode disbursementMode)
LinksList<LinkDescription>Optional, Read-onlyAn array of related HATEOAS links.List getLinks()setLinks(List links)
ProcessorResponseProcessorResponseOptionalThe processor response information for payment requests, such as direct credit card transactions.ProcessorResponse getProcessorResponse()setProcessorResponse(ProcessorResponse processorResponse)
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)
SupplementaryDataPaymentSupplementaryDataOptionalThe supplementary data.PaymentSupplementaryData getSupplementaryData()setSupplementaryData(PaymentSupplementaryData supplementaryData)
PayeePayeeBaseOptionalThe details for the merchant who receives the funds and fulfills the order. The merchant is also known as the payee.PayeeBase getPayee()setPayee(PayeeBase payee)

Example (as JSON)

{
  "final_capture": false,
  "disbursement_mode": "INSTANT",
  "status": "PARTIALLY_REFUNDED",
  "status_details": {
    "reason": "VERIFICATION_REQUIRED"
  },
  "id": "id4",
  "amount": {
    "currency_code": "currency_code6",
    "value": "value0"
  },
  "invoice_id": "invoice_id4"
}