Immediate Capture

DOCS

Last updated: Feb 27th, 8:28am

You can immediately capture money from your buyers and move it to your sellers.

Integration Steps

Before implementing immediate capture, you must complete Seller Onboarding and Checkout. Then, complete the following steps:

Create an order.
Capture an order.

Create an order

Before you capture funds, you must create an order with the intent field set to CAPTURE.

cURL
Node

1curl -v -X POST https://api-m.sandbox.paypal.com/v2/checkout/orders
2-H 'Content-Type: application/json'
3-H 'Authorization: Bearer &lt;Access-Token&gt;'
4-H 'PayPal-Partner-Attribution-Id: &lt;BN-Code&gt;'
5-d '{
6"intent": "CAPTURE",
7"purchase_units": [{
8"amount": {
9    "currency_code": "USD",
10    "value": "100.00"
11},
12"payee": {
13    "email_address": "seller@example.com"
14},
15"payment_instruction": {
16    "disbursement_mode": "INSTANT",
17    "platform_fees": [{
18    "amount": {
19        "currency_code": "USD",
20        "value": "25.00"
21    }
22    }]
23}
24}]
25}'

Use the purchase_units/payee object to specify the end receiver of the funds.
Use the purchase_units/payment_instruction/disbursement_mode field to specify when funds should be disbursed to the payee upon calling capture order. In this example, funds are disbursed immediately upon capture. To hold these funds, see the Delay Disbursements guide.
Use the purchase_units/payment_instruction/platform_fees array to specify fees for the order.

Capture an order

After your buyer approves the order, you call capture order to capture the buyer's funds.

1curl -v -k -X POST https://api-m.paypal.com/v2/checkout/orders/5O190127TN364715T/capture
2-H 'PayPal-Partner-Attribution-Id:'&lt;BN-Code&gt;'
3-H 'Authorization: Bearer &lt;Access-Token&gt;'
4-H 'Content-Type: application/json'
5-d '{}'

Note: Orders cannot be captured until the status of the order is set to APPROVED. The order status is set to APPROVED when the buyer successfully completes the checkout flow.

Accept Multi-seller Payments

Show Order Details

Delay Disbursement

Handle a Refund

Immediate Capture

Integration Steps

Create an order

Capture an order

Next