Account
Payment Methods List
https://api.linode.com/v4/account/payment-methods
Returns a paginated list of Payment Methods for this Account.
Query Parameters
The page of a collection to return.
The number of items to return per page.
Request Samples
- Shell
- CLI
curl -H "Authorization: Bearer $TOKEN" \
https://api.linode.com/v4/account/payment-methods
Response Samples
- 200
- default
{
"data": [
{
"id": "",
"created": "2018-01-15T00:01:01",
"type": "credit_card",
"is_default": true,
"data": {
"card_type": "Discover",
"last_four": "1234",
"expiry": "06/2022",
"email": "example@linode.com",
"paypal_id": "ABC1234567890"
}
}
],
"page": 1,
"pages": 1,
"results": 1
}
Responses
200: Returns a paginated list of Payment Method objects.
The unique ID of this Payment Method.
When the Payment Method was added to the Account.
The type of Payment Method.
Whether this Payment Method is the default method for automatically processing service charges.
The type of credit card.
The last four digits of the credit card number.
The expiration month and year of the credit card.
The type of credit card.
The last four digits of the credit card number.
The expiration month and year of the credit card.
The email address associated with your PayPal account.
PayPal Merchant ID associated with your PayPal account.
The current page.
The total number of pages.
The total number of results.
default: Error
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.
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.
Payment Method Add
https://api.linode.com/v4/account/payment-methods
Adds a Payment Method to your Account with the option to set it as the default method.
Adding a default Payment Method removes the default status from any other Payment Method.
An Account can have up to 6 active Payment Methods.
Up to 60 Payment Methods can be added each day.
Prior to adding a Payment Method, ensure that your billing address information is up-to-date with a valid
zip
by using the Account Update (PUT /account) endpoint.A
payment_method_add
event is generated when a payment is successfully submitted.
Request Body Schema
An object representing the credit card information you have on file with Linode to make Payments against your Account.
Your credit card number. No spaces or dashes allowed.
A value from 1-12 representing the expiration month of your credit card.
- 1 = January
- 2 = February
- 3 = March
- Etc.
A four-digit integer representing the expiration year of your credit card.
The combination of expiry_month
and expiry_year
must result in a month/year combination of the current month or in
the future. An expiration date set in the past is invalid.
CVV (Card Verification Value) of the credit card, typically found on the back of the card.
Whether this Payment Method is the default method for automatically processing service charges.
The type of Payment Method.
Alternative Payment Methods including Google Pay and PayPal can be added using the Cloud Manager. See the Manage Payment Methods guide for details and instructions.
Request Samples
- Shell
- CLI
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X POST -d '{
"type": "credit_card",
"is_default": true,
"data": {
"card_number": "4111111111111111",
"expiry_month": 11,
"expiry_year": 2020,
"cvv": "111"
}
}' \
https://api.linode.com/v4/account/payment-methods
Response Samples
- 200
- default
{}
Responses
200: Payment Method added.
default: Error
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.
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.