PayPal Captures API

Use the `/captures` resource to show details for and refund a captured payment.

OpenAPI Specification

paypal-captures-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: Paypal Subscriptions Authorizations Captures API
  description: You can use billing plans and subscriptions to create subscriptions that process recurring PayPal payments for physical or digital goods, or services. A plan includes pricing and billing cycle information that defines the amount and frequency of charge for a subscription. You can also define a fixed plan, such as a $5 basic plan or a volume- or graduated-based plan with pricing tiers based on the quantity purchased. For more information, see <a href="/docs/subscriptions/">Subscriptions Overview</a>.
  version: '1.6'
  contact: {}
servers:
- url: https://api-m.sandbox.paypal.com
  description: PayPal Sandbox Environment
- url: https://api-m.paypal.com
  description: PayPal Live Environment
tags:
- name: Captures
  description: Use the `/captures` resource to show details for and refund a captured payment.
paths:
  /v2/payments/captures/{capture_id}:
    get:
      summary: Paypal Show captured payment details
      description: Shows details for a captured payment, by ID.
      operationId: captures.get
      parameters:
      - $ref: '#/components/parameters/capture_id'
      responses:
        '200':
          description: A successful request returns the HTTP <code>200 OK</code> status code and a JSON response body that shows captured payment details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/capture-2'
        '401':
          description: Authentication failed due to missing authorization header, or invalid authentication credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_401'
        '403':
          description: The request failed because the caller has insufficient permissions.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/error_403'
                - $ref: '#/components/schemas/403'
        '404':
          description: The request failed because the resource does not exist.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/error_404'
                - $ref: '#/components/schemas/404'
        '500':
          description: The request failed because an internal server error occurred.
        default:
          $ref: '#/components/responses/default'
      tags:
      - Captures
      security:
      - Oauth2:
        - https://uri.paypal.com/services/payments/payment/authcapture
  /v2/payments/captures/{capture_id}/refund:
    post:
      summary: Paypal Refund captured payment
      description: Refunds a captured payment, by ID. For a full refund, include an empty payload in the JSON request body. For a partial refund, include an <code>amount</code> object in the JSON request body.
      operationId: captures.refund
      parameters:
      - $ref: '#/components/parameters/capture_id'
      - $ref: '#/components/parameters/paypal_request_id'
      - $ref: '#/components/parameters/prefer'
      - $ref: '#/components/parameters/paypal_auth_assertion'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/refund_request'
            examples:
              refund_request:
                value:
                  amount:
                    value: '10.00'
                    currency_code: USD
                  invoice_id: INVOICE-123
                  note_to_payer: DefectiveProduct
                  payment_instruction:
                    platform_fees:
                    - amount:
                        currency_code: USD
                        value: '1.00'
      responses:
        '201':
          description: A successful request returns the HTTP <code>201 Created</code> status code and a JSON response body that shows refund details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/refund'
        '400':
          description: The request failed because it is not well-formed or is syntactically incorrect or violates schema.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/error_400'
                - $ref: '#/components/schemas/captures.refund-400'
        '401':
          description: Authentication failed due to missing authorization header, or invalid authentication credentials.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/error_401'
                - $ref: '#/components/schemas/401'
        '403':
          description: The request failed because the caller has insufficient permissions.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/error_403'
                - $ref: '#/components/schemas/403'
        '404':
          description: The request failed because the resource does not exist.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/error_404'
                - $ref: '#/components/schemas/404'
        '409':
          description: The request failed because a previous call for the given resource is in progress.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/error_409'
                - $ref: '#/components/schemas/409'
        '422':
          description: The request failed because it either is semantically incorrect or failed business validation.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/error_422'
                - $ref: '#/components/schemas/captures.refund-422'
        '500':
          description: The request failed because an internal server error occurred.
        default:
          $ref: '#/components/responses/default'
      tags:
      - Captures
      security:
      - Oauth2:
        - https://uri.paypal.com/services/payments/refund
components:
  schemas:
    error_404:
      type: object
      title: Not found Error
      description: The server has not found anything matching the request URI. This either means that the URI is incorrect or the resource is not available.
      properties:
        name:
          type: string
          enum:
          - RESOURCE_NOT_FOUND
        message:
          type: string
          enum:
          - The specified resource does not exist.
        details:
          type: array
          items:
            $ref: '#/components/schemas/error_details'
        debug_id:
          type: string
          description: The PayPal internal ID. Used for correlation purposes.
        links:
          description: An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).
          type: array
          minItems: 0
          maxItems: 10000
          items:
            $ref: '#/components/schemas/error_link_description'
    payment_instruction-2:
      type: object
      title: Payment Instruction
      description: Any additional payments instructions during refund payment processing. This object is only applicable to merchants that have been enabled for PayPal Commerce Platform for Marketplaces and Platforms capability. Please speak to your account manager if you want to use this capability.
      properties:
        platform_fees:
          type: array
          description: Specifies the amount that the API caller will contribute to the refund being processed. The amount needs to be lower than platform_fees amount originally captured or the amount that is remaining if multiple refunds have been processed. This field is only applicable to merchants that have been enabled for PayPal Commerce Platform for Marketplaces and Platforms capability. Please speak to your account manager if you want to use this capability.
          minItems: 0
          maxItems: 1
          items:
            $ref: '#/components/schemas/platform_fee'
    disbursement_mode:
      type: string
      title: Disbursement Mode
      description: The funds that are held on behalf of the merchant.
      default: INSTANT
      minLength: 1
      maxLength: 16
      pattern: ^[A-Z_]+$
      enum:
      - INSTANT
      - DELAYED
    error_409:
      type: object
      title: Resource Conflict Error
      description: The server has detected a conflict while processing this request.
      properties:
        name:
          type: string
          enum:
          - RESOURCE_CONFLICT
        message:
          type: string
          enum:
          - The server has detected a conflict while processing this request.
        details:
          type: array
          items:
            $ref: '#/components/schemas/error_details'
        debug_id:
          type: string
          description: The PayPal internal ID. Used for correlation purposes.
        links:
          description: An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).
          type: array
          minItems: 0
          maxItems: 10000
          items:
            $ref: '#/components/schemas/error_link_description'
    supplementary_data:
      title: Supplementary Data
      type: object
      description: The supplementary data.
      properties:
        related_ids:
          description: Identifiers related to a specific resource.
          readOnly: true
          $ref: '#/components/schemas/related_ids'
    net_amount_breakdown_item:
      type: object
      title: Net Amount Breakdown Item
      description: The net amount. Returned when the currency of the refund is different from the currency of the PayPal account where the merchant holds their funds.
      properties:
        payable_amount:
          description: The net amount debited from the merchant's PayPal account.
          readOnly: true
          $ref: '#/components/schemas/money'
        converted_amount:
          description: The converted payable amount.
          readOnly: true
          $ref: '#/components/schemas/money'
        exchange_rate:
          description: The exchange rate that determines the amount that was debited from the merchant's PayPal account.
          readOnly: true
          $ref: '#/components/schemas/exchange_rate'
    '403':
      properties:
        details:
          type: array
          items:
            anyOf:
            - title: PERMISSION_DENIED
              properties:
                issue:
                  type: string
                  enum:
                  - PERMISSION_DENIED
                description:
                  type: string
                  enum:
                  - You do not have permission to access or perform operations on this resource.
    account_id:
      type: string
      title: PayPal Account Identifier
      description: The account identifier for a PayPal account.
      format: ppaas_payer_id_v3
      minLength: 13
      maxLength: 13
      pattern: ^[2-9A-HJ-NP-Z]{13}$
    link_description:
      type: object
      title: Link Description
      description: The request-related [HATEOAS link](/api/rest/responses/#hateoas-links) information.
      required:
      - href
      - rel
      properties:
        href:
          type: string
          description: The complete target URL. To make the related call, combine the method with this [URI Template-formatted](https://tools.ietf.org/html/rfc6570) link. For pre-processing, include the `$`, `(`, and `)` characters. The `href` is the key HATEOAS component that links a completed call with a subsequent call.
        rel:
          type: string
          description: The [link relation type](https://tools.ietf.org/html/rfc5988#section-4), which serves as an ID for a link that unambiguously describes the semantics of the link. See [Link Relations](https://www.iana.org/assignments/link-relations/link-relations.xhtml).
        method:
          type: string
          description: The HTTP method required to make the related call.
          enum:
          - GET
          - POST
          - PUT
          - DELETE
          - HEAD
          - CONNECT
          - OPTIONS
          - PATCH
    error_403:
      type: object
      title: Not Authorized Error
      description: 'The client is not authorized to access this resource, although it may have valid credentials. '
      properties:
        name:
          type: string
          enum:
          - NOT_AUTHORIZED
        message:
          type: string
          enum:
          - Authorization failed due to insufficient permissions.
        details:
          type: array
          items:
            $ref: '#/components/schemas/error_details'
        debug_id:
          type: string
          description: The PayPal internal ID. Used for correlation purposes.
        links:
          description: An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).
          type: array
          minItems: 0
          maxItems: 10000
          items:
            $ref: '#/components/schemas/error_link_description'
    capture:
      type: object
      title: Capture
      description: A captured payment.
      allOf:
      - $ref: '#/components/schemas/capture_status'
      - properties:
          id:
            description: The PayPal-generated ID for the captured payment.
            type: string
            readOnly: true
          amount:
            description: The amount for this captured payment.
            $ref: '#/components/schemas/money'
            readOnly: true
          invoice_id:
            description: 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.
            type: string
            readOnly: true
          custom_id:
            type: string
            description: The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.
            maxLength: 127
          network_transaction_reference:
            $ref: '#/components/schemas/network_transaction_reference'
          seller_protection:
            $ref: '#/components/schemas/seller_protection'
            readOnly: true
          final_capture:
            description: 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.
            type: boolean
            default: false
            readOnly: true
          seller_receivable_breakdown:
            $ref: '#/components/schemas/seller_receivable_breakdown'
            readOnly: true
          disbursement_mode:
            $ref: '#/components/schemas/disbursement_mode'
          links:
            description: An array of related [HATEOAS links](/docs/api/reference/api-responses/#hateoas-links).
            type: array
            readOnly: true
            items:
              $ref: '#/components/schemas/link_description'
          processor_response:
            description: An object that provides additional processor information for a direct credit card transaction.
            $ref: '#/components/schemas/processor_response'
      - $ref: '#/components/schemas/activity_timestamps'
    card_brand:
      type: string
      title: Card Brand
      description: The card network or brand. Applies to credit, debit, gift, and payment cards.
      minLength: 1
      maxLength: 255
      pattern: ^[A-Z_]+$
      enum:
      - VISA
      - MASTERCARD
      - DISCOVER
      - AMEX
      - SOLO
      - JCB
      - STAR
      - DELTA
      - SWITCH
      - MAESTRO
      - CB_NATIONALE
      - CONFIGOGA
      - CONFIDIS
      - ELECTRON
      - CETELEM
      - CHINA_UNION_PAY
    error_422:
      type: object
      title: Unprocessable Entity Error
      description: The requested action cannot be performed and may require interaction with APIs or processes outside of the current request. This is distinct from a 500 response in that there are no systemic problems limiting the API from performing the request.
      properties:
        name:
          type: string
          enum:
          - UNPROCESSABLE_ENTITY
        message:
          type: string
          enum:
          - The requested action could not be performed, semantically incorrect, or failed business validation.
        details:
          type: array
          items:
            $ref: '#/components/schemas/error_details'
        debug_id:
          type: string
          description: The PayPal internal ID. Used for correlation purposes.
        links:
          description: An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).
          type: array
          minItems: 0
          maxItems: 10000
          items:
            $ref: '#/components/schemas/error_link_description'
    exchange_rate:
      description: The exchange rate that determines the amount to convert from one currency to another currency.
      type: object
      title: Exchange Rate
      properties:
        source_currency:
          description: The source currency from which to convert an amount.
          $ref: '#/components/schemas/currency_code'
        target_currency:
          description: The target currency to which to convert an amount.
          $ref: '#/components/schemas/currency_code'
        value:
          description: The target currency amount. Equivalent to one unit of the source currency. Formatted as integer or decimal value with one to 15 digits to the right of the decimal point.
          type: string
      readOnly: true
    error_details:
      title: Error Details
      type: object
      description: The error details. Required for client-side `4XX` errors.
      properties:
        field:
          type: string
          description: The field that caused the error. If this field is in the body, set this value to the field's JSON pointer value. Required for client-side errors.
        value:
          type: string
          description: The value of the field that caused the error.
        location:
          $ref: '#/components/schemas/error_location'
        issue:
          type: string
          description: The unique, fine-grained application-level error code.
        description:
          type: string
          description: The human-readable description for an issue. The description can change over the lifetime of an API, so clients must not depend on this value.
      required:
      - issue
    error_link_description:
      title: Link Description
      description: The request-related [HATEOAS link](/api/rest/responses/#hateoas-links) information.
      type: object
      required:
      - href
      - rel
      properties:
        href:
          description: The complete target URL. To make the related call, combine the method with this [URI Template-formatted](https://tools.ietf.org/html/rfc6570) link. For pre-processing, include the `$`, `(`, and `)` characters. The `href` is the key HATEOAS component that links a completed call with a subsequent call.
          type: string
          minLength: 0
          maxLength: 20000
          pattern: ^.*$
        rel:
          description: The [link relation type](https://tools.ietf.org/html/rfc5988#section-4), which serves as an ID for a link that unambiguously describes the semantics of the link. See [Link Relations](https://www.iana.org/assignments/link-relations/link-relations.xhtml).
          type: string
          minLength: 0
          maxLength: 100
          pattern: ^.*$
        method:
          description: The HTTP method required to make the related call.
          type: string
          minLength: 3
          maxLength: 6
          pattern: ^[A-Z]*$
          enum:
          - GET
          - POST
          - PUT
          - DELETE
          - PATCH
    refund_request:
      title: Refund Request
      type: object
      description: Refunds a captured payment, by ID. For a full refund, include an empty request body. For a partial refund, include an <code>amount</code> object in the request body.
      properties:
        amount:
          description: The amount to refund. To refund a portion of the captured amount, specify an amount. If amount is not specified, an amount equal to <code>captured amount - previous refunds</code> is refunded. The amount must be a positive number and in the same currency as the one in which the payment was captured.
          $ref: '#/components/schemas/money'
        custom_id:
          type: string
          description: The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports. The pattern is defined by an external party and supports Unicode.
          minLength: 1
          maxLength: 127
          pattern: ^.*$
        invoice_id:
          type: string
          description: The API caller-provided external invoice ID for this order. The pattern is defined by an external party and supports Unicode.
          minLength: 1
          maxLength: 127
          pattern: ^.*$
        note_to_payer:
          type: string
          description: The reason for the refund. Appears in both the payer's transaction history and the emails that the payer receives. The pattern is defined by an external party and supports Unicode.
          minLength: 1
          maxLength: 255
          pattern: ^.*$
        payment_instruction:
          description: Any additional refund instructions to be set during refund payment processing. This object is only applicable to merchants that have been enabled for PayPal Commerce Platform for Marketplaces and Platforms capability. Please speak to your account manager if you want to use this capability.
          $ref: '#/components/schemas/payment_instruction-2'
    refund:
      type: object
      title: Refund
      description: The refund information.
      allOf:
      - $ref: '#/components/schemas/refund_status'
      - properties:
          id:
            description: The PayPal-generated ID for the refund.
            type: string
            readOnly: true
          amount:
            description: The amount that the payee refunded to the payer.
            $ref: '#/components/schemas/money'
            readOnly: true
          invoice_id:
            description: 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.
            type: string
            readOnly: true
          custom_id:
            type: string
            description: The API caller-provided external ID. Used to reconcile API caller-initiated transactions with PayPal transactions. Appears in transaction and settlement reports.
            minLength: 1
            maxLength: 127
            pattern: ^[A-Za-z0-9-_.,]*$
          acquirer_reference_number:
            type: string
            description: Reference ID issued for the card transaction. This ID can be used to track the transaction across processors, card brands and issuing banks.
            minLength: 1
            maxLength: 36
            pattern: ^[a-zA-Z0-9]+$
          note_to_payer:
            description: The reason for the refund. Appears in both the payer's transaction history and the emails that the payer receives.
            type: string
            readOnly: true
          seller_payable_breakdown:
            description: The breakdown of the refund.
            type: object
            title: Merchant Payable Breakdown
            properties:
              gross_amount:
                description: The amount that the payee refunded to the payer.
                $ref: '#/components/schemas/money'
                readOnly: true
              paypal_fee:
                description: The PayPal fee that was refunded to the payer in the currency of the transaction. This fee might not match the PayPal fee that the payee paid when the payment was captured.
                $ref: '#/components/schemas/money'
                readOnly: true
              paypal_fee_in_receivable_currency:
                description: The PayPal fee that was refunded to the payer in the receivable currency. Returned only in cases when the receivable currency is different from transaction currency. Example 'CNY'.
                $ref: '#/components/schemas/money'
                readOnly: true
              net_amount:
                description: The net amount that the payee's account is debited in the transaction currency. The net amount is calculated as <code>gross_amount</code> minus <code>paypal_fee</code> minus <code>platform_fees</code>.
                $ref: '#/components/schemas/money'
                readOnly: true
              net_amount_in_receivable_currency:
                description: The net amount that the payee's account is debited in the receivable currency. Returned only in cases when the receivable currency is different from transaction currency. Example 'CNY'.
                $ref: '#/components/schemas/money'
                readOnly: true
              platform_fees:
                type: array
                description: An array of platform or partner fees, commissions, or brokerage fees for the refund.
                minItems: 0
                maxItems: 1
                items:
                  $ref: '#/components/schemas/platform_fee'
              net_amount_breakdown:
                type: array
                description: An array of breakdown values for the net amount. Returned when the currency of the refund is different from the currency of the PayPal account where the payee holds their funds.
                items:
                  $ref: '#/components/schemas/net_amount_breakdown_item'
                readOnly: true
              total_refunded_amount:
                description: The total amount refunded from the original capture to date. For example, if a payer makes a $100 purchase and was refunded $20 a week ago and was refunded $30 in this refund, the `gross_amount` is $30 for this refund and the `total_refunded_amount` is $50.
                $ref: '#/components/schemas/money'
            readOnly: true
          payer:
            description: The details associated with the merchant for this transaction.
            $ref: '#/components/schemas/payee_base'
            readOnly: true
          links:
            description: An array of related [HATEOAS links](/docs/api/reference/api-responses/#hateoas-links).
            type: array
            readOnly: true
            items:
              $ref: '#/components/schemas/link_description'
      - $ref: '#/components/schemas/activity_timestamps'
    processor_response:
      type: object
      title: Processor Response
      description: The processor response information for payment requests, such as direct credit card transactions.
      properties:
        avs_code:
          description: The address verification code for Visa, Discover, Mastercard, or American Express transactions.
          type: string
          readOnly: true
          enum:
          - A
          - B
          - C
          - D
          - E
          - F
          - G
          - I
          - M
          - N
          - P
          - R
          - S
          - U
          - W
          - X
          - Y
          - Z
          - 'Null'
          - '0'
          - '1'
          - '2'
          - '3'
          - '4'
        cvv_code:
          description: The card verification value code for for Visa, Discover, Mastercard, or American Express.
          type: string
          readOnly: true
          enum:
          - E
          - I
          - M
          - N
          - P
          - S
          - U
          - X
          - All others
          - '0'
          - '1'
          - '2'
          - '3'
          - '4'
        response_code:
          description: Processor response code for the non-PayPal payment processor errors.
          type: string
          readOnly: true
          enum:
          - '0000'
          - 00N7
          - '0100'
          - 0390
          - '0500'
          - 0580
          - 0800
          - 0880
          - 0890
          - 0960
          - 0R00
          - '1000'
          - 10BR
          - '1300'
          - '1310'
          - '1312'
          - '1317'
          - '1320'
          - '1330'
          - '1335'
          - '1340'
          - '1350'
          - '1352'
          - '1360'
          - '1370'
          - '1380'
          - '1382'
          - '1384'
          - '1390'
          - '1393'
          - '5100'
          - '5110'
          - '5120'
          - '5130'
          - '5135'
          - '5140'
          - '5150'
          - '5160'
          - '5170'
          - '5180'
          - '5190'
          - '5200'
          - '5210'
          - '5400'
          - '5500'
          - '5650'
          - '5700'
          - '5710'
          - '5800'
          - '5900'
          - '5910'
          - '5920'
          - '5930'
          - '5950'
          - '6300'
          - '7600'
          - '7700'
          - '7710'
          - '7800'
          - '7900'
          - '8000'
          - '8010'
          - '8020'
          - '8030'
          - '8100'
          - '8110'
          - '8220'
          - '9100'
          - '9500'
          - '9510'
          - '9520'
          - '9530'
          - '9540'
          - '9600'
          - PCNR
          - PCVV
          - PP06
          - PPRN
          - PPAD
          - PPAB
          - PPAE
          - PPAG
          - PPAI
          - PPAR
          - PPAU
          - PPAV
          - PPAX
          - PPBG
          - PPC2
          - PPCE
          - PPCO
          - PPCR
          - PPCT
          - PPCU
          - PPD3
          - PPDC
          - PPDI
          - PPDV
          - PPDT
          - PPEF
          - PPEL
          - PPER
          - PPEX
          - PPFE
          - PPFI
          - PPFR
          - PPFV
          - PPGR
          - PPH1
          - PPIF
          - PPII
          - PPIM
          - PPIT
          - PPLR
          - PPLS
          - PPMB
          - PPMC
          - PPMD
          - PPNC
          - PPNL
          - PPNM
          - PPNT
          - PPPH
          - PPPI
          - PPPM
          - PPQC
          - PPRE
          - PPRF
          - PPRR
          - PPS0
          - PPS1
          - PPS2
          - PPS3
          - PPS4
          - PPS5
          - PPS6
          - PPSC
          - PPSD
          - PPSE
          - PPTE
          - PPTF
          - PPTI
          - PPTR
          - PPTT
          - PPTV
          - PPUA
          - PPUC
          - PPUE
          - PPUI
          - PPUP
          - PPUR
          - PPVC
          - PPVE
          - PPVT
        payment_advice_code:
          description: The declined payment transactions might have payment advice codes. The card networks, like Visa and Mastercard, return payment advice codes.
          type: string
          readOnly: true
          enum:
          - '01'
          - '02'
          - '03'
          - '21'
    related_ids:
      type: object
      title: Related Identifiers
      description: Identifiers related to a specific resource.
      properties:
        order_id:
          type: string
          description: Order ID related to the resource.
          minLength: 1
          maxLength: 20
          pattern: ^[A-Z0-9]+$
        authorization_id:
          type: string
          description: Authorization ID related to the resource.
          minLength: 1
          maxLength: 20
          pattern: ^[A-Z0-9]+$
        capture_id:
          type: string
          description: Capture ID related to the resource.
          minLength: 1
          maxLength: 20
          pattern: ^[A-Z0-9]+$
    error_default:
      description: The default error response.
      oneOf:
      - $ref: '#/components/schemas/error_400'
      - $ref: '#/components/schemas/error_401'
      - $ref: '#/components/schemas/error_403'
      - $ref: '#/components/schemas/error_404'
      - $ref: '#/components/schemas/er

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/paypal/refs/heads/main/openapi/paypal-captures-api-openapi.yml