PayPal REST API Samples

Request Object

{
    "sender_batch_header": {
        "sender_batch_id": "676d055905569",
        "email_subject": "You have a payment"
    },
    "items": [
        {
            "recipient_type": "Email",
            "note": "Thanks you.",
            "receiver": "shirt-supplier-one@gmail.com",
            "sender_item_id": "item_1676d05590565a",
            "amount": {
                "value": "0.99",
                "currency": "USD"
            }
        },
        {
            "recipient_type": "EMAIL",
            "amount": {
                "value": "0.90",
                "currency": "USD"
            },
            "receiver": "shirt-supplier-two@mail.com",
            "note": "Thank you.",
            "sender_item_id": "item_2"
        },
        {
            "recipient_type": "EMAIL",
            "receiver": "shirt-supplier-three@mail.com",
            "note": "Thank you.",
            "sender_item_id": "676d055905b90",
            "amount": {
                "value": "0.90",
                "currency": "USD"
            }
        }
    ]
}

Response Object

{
    "batch_header": {
        "payout_batch_id": "P42ETT25DQPU8",
        "batch_status": "PENDING",
        "sender_batch_header": {
            "sender_batch_id": "676d055905569",
            "email_subject": "You have a payment"
        }
    },
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/P42ETT25DQPU8",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

Request
Response

Request Object

{
    "sender_batch_header": {
        "sender_batch_id": "676d055905569",
        "email_subject": "You have a payment"
    },
    "items": [
        {
            "recipient_type": "Email",
            "note": "Thanks you.",
            "receiver": "shirt-supplier-one@gmail.com",
            "sender_item_id": "item_1676d05590565a",
            "amount": {
                "value": "0.99",
                "currency": "USD"
            }
        },
        {
            "recipient_type": "EMAIL",
            "amount": {
                "value": "0.90",
                "currency": "USD"
            },
            "receiver": "shirt-supplier-two@mail.com",
            "note": "Thank you.",
            "sender_item_id": "item_2"
        },
        {
            "recipient_type": "EMAIL",
            "receiver": "shirt-supplier-three@mail.com",
            "note": "Thank you.",
            "sender_item_id": "676d055905b90",
            "amount": {
                "value": "0.90",
                "currency": "USD"
            }
        }
    ]
}

Response Object

{
    "batch_header": {
        "payout_batch_id": "P42ETT25DQPU8",
        "batch_status": "PENDING",
        "sender_batch_header": {
            "sender_batch_id": "676d055905569",
            "email_subject": "You have a payment"
        }
    },
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/P42ETT25DQPU8",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

Request Object

No Data

Response Object

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

Warning: sizeof(): Parameter must be an array or an object that implements Countable in /home/conexti1/public_html/library/PayPal/vendor/paypal/rest-api-sdk-php/lib/PayPal/Common/PayPalModel.php on line 176

{
    "batch_header": {
        "payout_batch_id": "P42ETT25DQPU8",
        "batch_status": "PENDING",
        "time_created": "2024-12-26T07:27:21Z",
        "sender_batch_header": {
            "sender_batch_id": "676d055905569",
            "email_subject": "You have a payment"
        },
        "funding_source": "BALANCE",
        "amount": {
            "currency": "USD",
            "value": "2.79"
        },
        "fees": {
            "currency": "USD",
            "value": "0.75"
        }
    },
    "items": [
        {
            "payout_item_id": "BB8L9DVW982KW",
            "transaction_status": "PENDING",
            "payout_item_fee": {
                "currency": "USD",
                "value": "0.25"
            },
            "payout_batch_id": "P42ETT25DQPU8",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.99"
                },
                "note": "Thanks you.",
                "receiver": "shirt-supplier-one@gmail.com",
                "sender_item_id": "item_1676d05590565a",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/BB8L9DVW982KW",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        },
        {
            "payout_item_id": "83XEZKZTVZWJ2",
            "transaction_status": "PENDING",
            "payout_item_fee": {
                "currency": "USD",
                "value": "0.25"
            },
            "payout_batch_id": "P42ETT25DQPU8",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.90"
                },
                "note": "Thank you.",
                "receiver": "shirt-supplier-two@mail.com",
                "sender_item_id": "item_2",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/83XEZKZTVZWJ2",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        },
        {
            "payout_item_id": "28N59WHBWNJHN",
            "transaction_status": "PENDING",
            "payout_item_fee": {
                "currency": "USD",
                "value": "0.25"
            },
            "payout_batch_id": "P42ETT25DQPU8",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.90"
                },
                "note": "Thank you.",
                "receiver": "shirt-supplier-three@mail.com",
                "sender_item_id": "676d055905b90",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/28N59WHBWNJHN",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        }
    ],
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/P42ETT25DQPU8?page_size=1000&page=1",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

Request
Response

Request Object

No Data

Response Object

{
    "batch_header": {
        "payout_batch_id": "P42ETT25DQPU8",
        "batch_status": "PENDING",
        "time_created": "2024-12-26T07:27:21Z",
        "sender_batch_header": {
            "sender_batch_id": "676d055905569",
            "email_subject": "You have a payment"
        },
        "funding_source": "BALANCE",
        "amount": {
            "currency": "USD",
            "value": "2.79"
        },
        "fees": {
            "currency": "USD",
            "value": "0.75"
        }
    },
    "items": [
        {
            "payout_item_id": "BB8L9DVW982KW",
            "transaction_status": "PENDING",
            "payout_item_fee": {
                "currency": "USD",
                "value": "0.25"
            },
            "payout_batch_id": "P42ETT25DQPU8",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.99"
                },
                "note": "Thanks you.",
                "receiver": "shirt-supplier-one@gmail.com",
                "sender_item_id": "item_1676d05590565a",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/BB8L9DVW982KW",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        },
        {
            "payout_item_id": "83XEZKZTVZWJ2",
            "transaction_status": "PENDING",
            "payout_item_fee": {
                "currency": "USD",
                "value": "0.25"
            },
            "payout_batch_id": "P42ETT25DQPU8",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.90"
                },
                "note": "Thank you.",
                "receiver": "shirt-supplier-two@mail.com",
                "sender_item_id": "item_2",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/83XEZKZTVZWJ2",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        },
        {
            "payout_item_id": "28N59WHBWNJHN",
            "transaction_status": "PENDING",
            "payout_item_fee": {
                "currency": "USD",
                "value": "0.25"
            },
            "payout_batch_id": "P42ETT25DQPU8",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "0.90"
                },
                "note": "Thank you.",
                "receiver": "shirt-supplier-three@mail.com",
                "sender_item_id": "676d055905b90",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/28N59WHBWNJHN",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        }
    ],
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/P42ETT25DQPU8?page_size=1000&page=1",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

❮❮ Back to Samples

1. Created Batch Payout

Request Object

Response Object

Request Object

Response Object

2. Get Payout Batch Status

Request Object

Response Object

Request Object

Response Object