Preparing the payment for execution

Problem
Your customer has approved the payment on Paypal – i.e. through PayPal checkout — and has been redirected to your client. You need to make sure it's ready to be executed.
Solution
To enable the payment execution with PayPal, you need to update the PayPal payment object. To do that, send a PATCH request to the /api/paypal_payments/:id endpoint, filling the payment_payer_id with the payer ID you just received from the client – see PayPal documentation for any reference.
Example
Request
Response
The following request updates the PayPal payment source identified by the "qaZPVIyoeg" ID with the payer ID received from the client:
1
curl -g -X PATCH \
2
  'http://yourdomain.commercelayer.io/api/paypal_payments/qaZPVIyoeg' \
3
  -H 'Accept: application/vnd.api+json' \
4
  -H 'Authorization: Bearer your-access-token' \
5
  -H 'Content-Type: application/vnd.api+json' \
6
  -d '{
7
  "data": {
8
    "type": "paypal_payments",
9
    "id": "qaZPVIyoeg",
10
    "attributes": {
11
      "paypal_payer_id": "aaabbbccc123"
12
    }
13
  }
14
}
Copied!
On success, the API responds with a 200 OK status code, returning the updated PayPal payment object:
1
{
2
  "data": {
3
    "id": "qaZPVIyoeg",
4
    "type": "paypal_payments",
5
    "links": {
6
      "self": "https://yourdomain.commercelayer.io/api/paypal_payments/qaZPVIyoeg"
7
    },
8
    "attributes": {
9
      "return_url": "https://checkout.yourdomain.com/jNbQLhMeqo/paypal",
10
      "cancel_url": "https://checkout.yourdomain.com/jNbQLhMeqo",
11
      "note_to_payer": null,
12
      "paypal_payer_id": "aaabbbccc123",
13
      "name": "aaabbbccc123",
14
      "paypal_id": "PAYID-xxxxyyyyzzzz",
15
      "status": "created",
16
      "approval_url": "https://www.sandbox.paypal.com/cgi-bin/webscr?cmd=_express-checkout&token=EC-123abc456",
17
      "created_at": "2018-01-01T12:00:00.000Z",
18
      "updated_at": "2018-01-01T12:00:00.000Z",
19
      "reference": null,
20
      "reference_origin": null,
21
      "metadata": {}
22
    },
23
    "relationships": {
24
      "order": {
25
        "links": {
26
          "self": "https://commerce-layer.commercelayer.co/api/paypal_payments/qaZPVIyoeg/relationships/order",
27
          "related": "https://commerce-layer.commercelayer.co/api/paypal_payments/qaZPVIyoeg/order"
28
        }
29
      }
30
    },
31
    "meta": {
32
      "mode": "test"
33
    }
34
  }
35
}
Copied!
More to read
See our documentation if you need more information on how to update a PayPal payment. See our Checkout guide for more details on how to place an order.
Placing the order

Adding the payment source

Stripe

Last modified 3mo ago

Copy link

Contents

Problem

Solution

Example