getPaymentMethods

get https://sellingpartnerapi-na.amazon.com/finances/transfers/2024-06-01/paymentMethods

Returns the list of payment methods for the seller, which can be filtered by method type.

Usage Plan:

Rate (requests per second)	Burst
.5	30

The x-amzn-RateLimit-Limit response header contains the usage plan rate limits for the operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput might have higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits.

Responses

Response body

object

paymentMethods

array of objects

The list of payment methods with payment method details.

paymentMethods

object

accountHolderName

string

The name of the account holder who is registered for the payment method.

paymentMethodId

string

The payment method identifier.

tail

string

The last three or four digits of the payment method.

expiryDate

object

The expiration date of the card used for payment. If the payment method is not card, the expiration date is null.

countryCode

string

The two-letter country code in ISO 3166-1 alpha-2 format. For payment methods in the card category, the code is for the country where the card was issued. For payment methods in the bank account category, the code is for the country where the account is located.

paymentMethodType

string

The type of payment method.

BANK_ACCOUNT CARD SELLER_WALLET

Show Details

BANK_ACCOUNT	The payment is from a bank account.
CARD	The payment is from a card.
SELLER_WALLET	The payment is from a [Seller Wallet](https://sell.amazon.com/tools/seller-wallet) virtual bank account.

assignmentType

string

The default payment method type.

DEFAULT_DEPOSIT_METHOD

Show Details

DEFAULT_DEPOSIT_METHOD

The default deposit method.

Headers

object

x-amzn-RateLimit-Limit

string

Your rate limit (requests per second) for this operation.

x-amzn-RequestId

string

Unique request reference identifier.

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://sellingpartnerapi-na.amazon.com/finances/transfers/2024-06-01/paymentMethods?paymentMethodTypes=' \
3
     --header 'accept: application/json'


xxxxxxxxxx
22
 
1
{
2
  "paymentMethods": [
3
    {
4
      "accountHolderName": "John Doe",
5
      "paymentMethodId": "0h_TU_CUS_4058fe2a-da6b-4b82-8e48-b20ff2eb4f6d",
6
      "paymentMethodType": "BANK_ACCOUNT",
7
      "tail": "677",
8
      "assignmentType": "DEFAULT_DEPOSIT_METHOD"
9
    },
10
    {
11
      "countryCode": "US",
12
      "accountHolderName": "John Doe",
13
      "paymentMethodId": "0h_TU_CUS_4058fe2a-da6b-4b82-8e48-b20ff2eb4f6d",
14
      "paymentMethodType": "CARD",
15
      "expiryDate": {
16
        "month": "3",
17
        "year": "2029"
18
      },
19
      "tail": "677"
20
    }
21
  ]
22
}

200Success.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.