action paypal_orders_confirm {
  label: "Confirm the Order"
  description: "Payer confirms their intent to pay for the the Order with the given payment source."
  provider: paypal
  method: POST
  path: "/v2/checkout/orders/{id}/confirm-payment-source"
  encoding: json
  input: {
    type: "object"
    properties: {
      Prefer: {
        type: "string"
      }
      application_context: {
        type: "object"
        description: "Customizes the payer confirmation experience."
        properties: {
          brand_name: {
            type: "string"
            description: "Label to present to your payer as part of the PayPal hosted web experience."
          }
          cancel_url: {
            type: "string"
            format: "uri"
            description: "The URL where the customer is redirected after the customer cancels the payment."
          }
          locale: {
            type: "object"
          }
          return_url: {
            type: "string"
            format: "uri"
            description: "The URL where the customer is redirected after the customer approves the payment."
          }
          stored_payment_source: {
            type: "object"
            description: "Provides additional details to process a payment using a `payment_source` that has been stored or is intended to be stored (also referred to as stored_credential or card-on-file).<br/>Parameter compatibility:<br/><ul><li>`payment_type=ONE_TIME` is compatible only with `payment_initiator=CUSTOMER`.</li><li>`usage=FIRST` is compatible only with `payment_initiator=CUSTOMER`.</li><li>`previous_transaction_reference` or `previous_network_transaction_reference` is compatible only with `payment_initiator=MERCHANT`.</li><li>Only one of the parameters - `previous_transaction_reference` and `previous_network_transaction_reference` - can be present in the request.</li></ul>"
            required: ["payment_initiator", "payment_type"]
            properties: {
              payment_initiator: {
                type: "string"
                description: "The person or party who initiated or triggered the payment."
                enum: ["CUSTOMER", "MERCHANT"]
              }
              payment_type: {
                type: "string"
                description: "Indicates the type of the stored payment_source payment."
                enum: ["ONE_TIME", "RECURRING", "UNSCHEDULED"]
              }
              previous_network_transaction_reference: {
                type: "object"
                description: "Reference values used by the card network to identify a transaction."
                required: ["id"]
              }
              usage: {
                type: "string"
                description: "Indicates if this is a `first` or `subsequent` payment using a stored payment source (also referred to as stored credential or card on file)."
                enum: ["FIRST", "SUBSEQUENT", "DERIVED"]
              }
            }
          }
        }
      }
      id: {
        type: "string"
      }
      payment_source: {
        type: "object"
        description: "The payment source definition."
        properties: {
          apple_pay: {
            type: "object"
          }
          bancontact: {
            type: "object"
          }
          blik: {
            type: "object"
          }
          card: {
            type: "object"
            description: "The payment card to use to fund a payment. Can be a credit or debit card.<blockquote><strong>Note:</strong> Passing card number, cvv and expiry directly via the API requires <a href=\"https://www.pcisecuritystandards.org/pci_security/completing_self_assessment\"> PCI SAQ D compliance</a>. <br>*PayPal offers a mechanism by which you do not have to take on the <strong>PCI SAQ D</strong> burden by using hosted fields - refer to <a href=\"https://developer.paypal.com/docs/checkout/advanced/integrate/\">this Integration Guide</a>*.</blockquote>"
          }
          crypto: {
            type: "object"
          }
          eps: {
            type: "object"
          }
          giropay: {
            type: "object"
          }
          google_pay: {
            type: "object"
          }
          ideal: {
            type: "object"
          }
          mybank: {
            type: "object"
          }
          p24: {
            type: "object"
          }
          paypal: {
            type: "object"
          }
          sofort: {
            type: "object"
          }
          token: {
            type: "object"
            description: "The tokenized payment source to fund a payment."
            required: ["id", "type"]
            properties: {
              id: {
                type: "string"
                description: "The PayPal-generated ID for the token."
              }
              type: {
                type: "string"
                description: "The tokenization method that generated the ID."
                enum: ["BILLING_AGREEMENT"]
              }
            }
          }
          trustly: {
            type: "object"
          }
          venmo: {
            type: "object"
          }
        }
      }
    }
    required: ["id", "payment_source"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "The order details."
  }
}