Account

Stage PayPal Payment

post
https://api.linode.com/v4/account/payments/paypal

This begins the process of submitting a Payment via PayPal. After calling this endpoint, you must take the resulting payment_id along with the payer_id from your PayPal account and POST /account/payments/paypal-execute to complete the Payment.

Authorizations

Personal Access Token
OAuth: ( account:read_write)

Request Body Schema

cancel_url
Required
string

The URL to have PayPal redirect to when Payment is cancelled.

redirect_url
Required
string

The URL to have PayPal redirect to when Payment is approved.

usd
Required
string

The payment amount in USD. Minimum accepted value of $5 USD. Maximum accepted value of $500 USD or credit card payment limit; whichever value is highest. PayPal's maximum transaction limit is $10,000 USD.

Request Samples

curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer $TOKEN" \
    -X POST -d '{
        "usd": "120.50",
        "redirect_url": "https://example.org",
        "cancel_url": "https://example.org"
    }' \
    https://api.linode.com/v4/account/payments/paypal

Response Samples

{
  "payment_id": "PAY-1234567890ABCDEFGHIJKLMN",
  "checkout_token": "EC-1A2B3C4D5E6F7G8H9"
}

Responses

200: PayPal Payment staged.

payment_id
string

The paypal-generated ID for this Payment. Used when authorizing the Payment in PayPal's interface.

checkout_token
string

The checkout token generated for this Payment.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.