Captured Payment
June 5, 2026 ยท View on GitHub
A captured payment.
Structure
CapturedPayment
Fields
| Name | Type | Tags | Description | Getter | Setter |
|---|---|---|---|---|---|
Status | CaptureStatus | Optional, Read-only | The status of the captured payment. | CaptureStatus getStatus() | setStatus(CaptureStatus status) |
StatusDetails | CaptureStatusDetails | Optional | The details of the captured payment status. | CaptureStatusDetails getStatusDetails() | setStatusDetails(CaptureStatusDetails statusDetails) |
Id | String | Optional, Read-only | The PayPal-generated ID for the captured payment. | 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: Maximum Length: 255 | String getCustomId() | setCustomId(String customId) |
NetworkTransactionReference | NetworkTransaction | Optional | Reference values used by the card network to identify a transaction. | NetworkTransaction getNetworkTransactionReference() | setNetworkTransactionReference(NetworkTransaction networkTransactionReference) |
SellerProtection | SellerProtection | Optional | The level of protection offered as defined by PayPal Seller Protection for Merchants. | SellerProtection getSellerProtection() | setSellerProtection(SellerProtection sellerProtection) |
FinalCapture | Boolean | Optional, Read-only | Indicates 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) |
SellerReceivableBreakdown | SellerReceivableBreakdown | Optional | The detailed breakdown of the capture activity. This is not available for transactions that are in pending state. | SellerReceivableBreakdown getSellerReceivableBreakdown() | setSellerReceivableBreakdown(SellerReceivableBreakdown sellerReceivableBreakdown) |
DisbursementMode | DisbursementMode | Optional | The funds that are held on behalf of the merchant. Default: DisbursementMode.INSTANTConstraints: Minimum Length: 1, Maximum Length: 16, Pattern: ^[A-Z_]+$ | DisbursementMode getDisbursementMode() | setDisbursementMode(DisbursementMode disbursementMode) |
Links | List<LinkDescription> | Optional, Read-only | An array of related HATEOAS links. | List | setLinks(List |
ProcessorResponse | ProcessorResponse | Optional | The processor response information for payment requests, such as direct credit card transactions. | ProcessorResponse getProcessorResponse() | setProcessorResponse(ProcessorResponse processorResponse) |
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) |
SupplementaryData | PaymentSupplementaryData | Optional | The supplementary data. | PaymentSupplementaryData getSupplementaryData() | setSupplementaryData(PaymentSupplementaryData supplementaryData) |
Payee | PayeeBase | Optional | The 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"
}