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":"https://example.com/return",
"cancel_url":"https://example.com/cancel"
}
}
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"
}
]
}