title: Swagger Format for PayPal Payment API
body: <p>I'm new to OpenAPI and I need some help to create a basic swagger file for PayPal's <a href="https://developer.paypal.com/docs/api/payments/#payment_create" rel="nofollow noreferrer">payment API</a> to create a payment from our platform. <strong>Note</strong>: OAuth is already configured.</p>
  
  <p>Below is a basic swagger file but I don't know where to add the <a href="https://developer.paypal.com/docs/integration/direct/make-your-first-call/#make-an-api-call" rel="nofollow noreferrer">paymet request information</a> (i.e. intent, payer, transactions etc.) into:</p>
  
  <pre><code>{
    "swagger": "2.0",
    "info": {
      "description": "this is a payment request to through PayPal",
      "title": "Swagger PayPal Payment",
      "version": "1.0.0"
    },
      "host": "api.sandbox.paypal.com",
      "basePath": "/v1/payments", //
      "schemes": [ "https" ],
    "paths": {
      "/payment":
      {
        "post": {
          "summary": "Creates a payment"
          "description": "Creates a payment request to Paypal",
          "parameters": {
  
          },
          //"intent": "sale",
          //"payer":
          //{
          //  "payment_method": "paypal"
          //},
          //"transactions": [
          //  {
          //    "amount": {
          //      "total": "9.00",
          //      "currency": "EUR"
          //    }
          //  }
          //],
          "responses": {
            "200": {
              "description": "OK"
            }
          }
        }
      }
    }
  }
  </code></pre>
  
  <p>Testing the file on editor.swagger, I get an "OBJECT_ADDITIONAL_PROPERTIES" error on transactions, payer, and intent.</p>