❮❮ Back to Samples

Request Object

{
    "sender_batch_header": {
        "sender_batch_id": "6a2a2a37f2fc2",
        "email_subject": "You have a Payout!"
    },
    "items": [
        {
            "recipient_type": "Email",
            "note": "Thanks for your patronage!",
            "receiver": "shirt-supplier-one@gmail.com",
            "sender_item_id": "2014031400023",
            "amount": {
                "value": "1.00",
                "currency": "USD"
            }
        }
    ]
}

Response Object

{
    "batch_header": {
        "payout_batch_id": "FX4YSX2CYN2XU",
        "batch_status": "SUCCESS",
        "time_created": "2026-06-11T03:23:36Z",
        "time_completed": "2026-06-11T03:23:37Z",
        "sender_batch_header": {
            "sender_batch_id": "6a2a2a37f2fc2",
            "email_subject": "You have a Payout!"
        },
        "funding_source": "BALANCE",
        "amount": {
            "currency": "USD",
            "value": "1.00"
        },
        "fees": {
            "currency": "USD",
            "value": "0.25"
        }
    },
    "items": [
        {
            "payout_item_id": "UCG8L28NJFKY6",
            "transaction_id": "1YX94692XK757961S",
            "activity_id": "5W485689WK1910820",
            "transaction_status": "UNCLAIMED",
            "payout_item_fee": {
                "currency": "USD",
                "value": "0.25"
            },
            "payout_batch_id": "FX4YSX2CYN2XU",
            "payout_item": {
                "recipient_type": "EMAIL",
                "amount": {
                    "currency": "USD",
                    "value": "1.00"
                },
                "note": "Thanks for your patronage!",
                "receiver": "shirt-supplier-one@gmail.com",
                "sender_item_id": "2014031400023",
                "recipient_wallet": "PAYPAL",
                "purpose": "GOODS"
            },
            "time_processed": "2026-06-11T03:23:37Z",
            "errors": {
                "name": "RECEIVER_UNREGISTERED",
                "message": "The recipient for this payout does not have an account. A link to sign up for an account was sent to the recipient. However, if the recipient does not claim this payout within 30 days, the funds will be returned to your account.",
                "information_link": "https://developer.paypal.com/docs/api/payments.payouts-batch/#errors",
                "details": [],
                "links": []
            },
            "links": [
                {
                    "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/UCG8L28NJFKY6",
                    "rel": "item",
                    "method": "GET",
                    "enctype": "application/json"
                }
            ]
        }
    ],
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/FX4YSX2CYN2XU?page_size=1&page=1",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}

Request Object

Response Object

{
    "payout_item_id": "UCG8L28NJFKY6",
    "transaction_id": "1YX94692XK757961S",
    "activity_id": "5W485689WK1910820",
    "transaction_status": "RETURNED",
    "payout_item_fee": {
        "currency": "USD",
        "value": "0.25"
    },
    "payout_batch_id": "FX4YSX2CYN2XU",
    "sender_batch_id": "6a2a2a37f2fc2",
    "payout_item": {
        "recipient_type": "EMAIL",
        "amount": {
            "currency": "USD",
            "value": "1.00"
        },
        "note": "Thanks for your patronage!",
        "receiver": "shirt-supplier-one@gmail.com",
        "sender_item_id": "2014031400023",
        "recipient_wallet": "PAYPAL",
        "purpose": "GOODS"
    },
    "time_processed": "2026-06-11T03:23:37Z",
    "errors": {
        "name": "RECEIVER_UNREGISTERED",
        "message": "The recipient for this payout does not have an account. A link to sign up for an account was sent to the recipient. However, if the recipient does not claim this payout within 30 days, the funds will be returned to your account.",
        "information_link": "https://developer.paypal.com/docs/api/payments.payouts-batch/#errors",
        "details": [],
        "links": []
    },
    "links": [
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts-item/UCG8L28NJFKY6",
            "rel": "self",
            "method": "GET",
            "enctype": "application/json"
        },
        {
            "href": "https://api.sandbox.paypal.com/v1/payments/payouts/FX4YSX2CYN2XU",
            "rel": "batch",
            "method": "GET",
            "enctype": "application/json"
        }
    ]
}