Refund Captured Payment Input

June 5, 2026 ยท View on GitHub

Input structure for the method RefundCapturedPaymentAsync

Structure

RefundCapturedPaymentInput

Fields

NameTypeTagsDescriptionGetterSetter
CaptureIdStringRequiredThe PayPal-generated ID for the captured payment to refund.String getCaptureId()setCaptureId(String captureId)
ContentTypeStringRequired, ConstantValue: "application/json"String getContentType()setContentType(String contentType)
PaypalMockResponseStringOptionalPayPal's REST API uses a request header to invoke negative testing in the sandbox. This header configures the sandbox into a negative testing state for transactions that include the merchant.String getPaypalMockResponse()setPaypalMockResponse(String paypalMockResponse)
PaypalRequestIdStringOptionalThe server stores keys for 45 days.String getPaypalRequestId()setPaypalRequestId(String paypalRequestId)
PreferStringOptionalThe preferred server response upon successful completion of the request. Value is: return=minimal. The server returns a minimal response to optimize communication between the API caller and the server. A minimal response includes the id, status and HATEOAS links. return=representation. The server returns a complete resource representation, including the current state of the resource.

Default: "return=minimal"
String getPrefer()setPrefer(String prefer)
PaypalAuthAssertionStringOptionalAn API-caller-provided JSON Web Token (JWT) assertion that identifies the merchant. For details, see PayPal-Auth-Assertion. Note:For three party transactions in which a partner is managing the API calls on behalf of a merchant, the partner must identify the merchant using either a PayPal-Auth-Assertion header or an access token with target_subject.String getPaypalAuthAssertion()setPaypalAuthAssertion(String paypalAuthAssertion)
BodyRefundRequestOptional-RefundRequest getBody()setBody(RefundRequest body)

Example

import com.paypal.sdk.models.Money;
import com.paypal.sdk.models.RefundCapturedPaymentInput;
import com.paypal.sdk.models.RefundPaymentInstruction;
import com.paypal.sdk.models.RefundPlatformFee;
import com.paypal.sdk.models.RefundRequest;
import java.util.Arrays;

RefundCapturedPaymentInput refundCapturedPaymentInput = new RefundCapturedPaymentInput.Builder(
    "capture_id2",
    "application/json"
)
.paypalMockResponse("PayPal-Mock-Response0")
.paypalRequestId("PayPal-Request-Id6")
.prefer("return=minimal")
.paypalAuthAssertion("PayPal-Auth-Assertion0")
.body(new RefundRequest.Builder()
        .amount(new Money.Builder(
            "currency_code6",
            "value0"
        )
        .build())
        .customId("custom_id4")
        .invoiceId("invoice_id6")
        .noteToPayer("note_to_payer8")
        .paymentInstruction(new RefundPaymentInstruction.Builder()
            .platformFees(Arrays.asList(
                new RefundPlatformFee.Builder(
                    new Money.Builder(
                        "currency_code6",
                        "value0"
                    )
                    .build()
                )
                .build(),
                new RefundPlatformFee.Builder(
                    new Money.Builder(
                        "currency_code6",
                        "value0"
                    )
                    .build()
                )
                .build(),
                new RefundPlatformFee.Builder(
                    new Money.Builder(
                        "currency_code6",
                        "value0"
                    )
                    .build()
                )
                .build()
            ))
            .build())
        .build())
.build();