Create a Payment Request

After receiving your access token, use it to issue a request to create a payment. Set the following request fields to these values:

Parameter Value
intent sale
payment_method paypal
allowed_payment_method IMMEDIATE_PAY

Example request

curl -v https://api.sandbox.paypal.com/v1/payments/payment \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-d '{
"intent":"sale",
   "payer":{ 
      "payment_method":"paypal"
   },
   "transactions":[ 
      { 
         "amount":{ 
            "currency":"BRL",
            "total":"95.00",
            "details":{ 
              "shipping":"11",
              "subtotal":"75",
              "shipping_discount":"1.00",
              "insurance":"1.00",
              "handling_fee":"1.00",
              "tax":"6.00"
            }
         },
         "description":"This is the payment transaction description",
         "payment_options":{ 
            "allowed_payment_method":"IMMEDIATE_PAY"
         },
         "item_list":{ 
            "shipping_address": {
                "recipient_name" : "PP Plus Recipient",
                "line1": "Gregório Rolim de Oliveira, 42",
                "line2": "JD Serrano II",
                "city": "Votorantim",
                "country_code": "BR",
                "postal_code": "18117-134",
                "state": "São Paulo",
                "phone": "0800-761-0880"
            },
            "items":[ 
               { 
                  "name":"handbag",
                  "description":"red diamond",
                  "quantity":"1",
                  "price":"75",
                  "tax":"6",
                  "sku":"product34",
                  "currency":"BRL"
               }
            ]
         }
      }
   ],
   "redirect_urls":{ 
      "return_url":"http://www.paypal.com",
      "cancel_url":"http://www.paypal.com"
   }
}

Example response

The response returns the approval_url link, which is required when you are integrating the payment selection page.

{
    "id": "PAY-3A3234483P2338009KTTFX7Q",
    "create_time": "2015-02-19T21:56:14Z",
    "update_time": "2015-02-19T21:56:14Z",
    "state": "created",
    "intent": "sale",
    "payer": {
        "payment_method": "paypal",
        "payer_info": {
            "shipping_address": {}
        }
    },
    "transactions": [
        {
            "amount": {
                "total": "95.00",
                "currency": "BRL",
                "details": {
                    "subtotal": "75.00",
                    "tax": "6.00",
                    "shipping": "11.00",
                    "handling_fee": "1.00",
                    "insurance": "1.00",
                    "shipping_discount": "1.00"
                }
            },
            "description": "This is the payment transaction description",
           "item_list": {
                "items": [
                    {
                        "name": "handbag",
                        "sku": "product34",
                        "price": "75.00",
                        "currency": "BRL",
                        "quantity": "1",
                        "description": "red diamond",
                        "tax": "6.00"
                    }
                ],
                "shipping_address": {
                    "recipient_name": "Max Santos",
                    "line1": "Greg?rio Rolim de Oliveira, 42",
                    "line2": "JD Serrano II",
                    "city": "Votorantim",
                    "state": "S?o Paulo",
                    "phone": "0800-761-0880",
                    "postal_code": "18117-134",
                    "country_code": "BR"
                }
            },
            "related_resources": []
        }
    ],
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payment/PAY-3A3234483P2338009KTTFX7Q",
            "rel": "self",
            "method": "GET"
        },
        {
            "href": "https://api.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token=EC-82237386YH588524U",
            "rel": "approval_url",
            "method": "REDIRECT"
        },
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payment/PAY-3A3234483P2338009KTTFX7Q/execute",
            "rel": "execute",
            "method": "POST"
        }
    ]
}

Next

Integrate a payment selection page