eBay Trading APIVersion 1119

BuyerPaymentMethodCodeType ( token )

This enumerated type defines different payment methods that can be used by buyers to pay sellers for purchases. Supported payment methods vary by eBay marketplace, by eBay Category, and even by listing format. If a seller is listing, revising, or relisting an item with a Trading API call, the seller should use one of the following metadata calls to see which payment methods are supported at the site and category level:


Note: If a seller is opted in to the new eBay Managed Payments program, a payment method does not need to be specified at listing time, as eBay manages the payment methods that are available to the buyer. Any payment method that is specified at listing time (or defined in a payment business policy) will be ignored and dropped from the listing, and the seller will get a warning message in the response. The eBay Managed Payments program is currently only available to a limited number of sellers on the US site, but this feature will be rolled out to more and more US sellers throughout 2019, and is expected to start being rolled out to some Germany sellers in Q3 of 2019.

Types that use BuyerPaymentMethodCodeType:

Calls that use one or more values of BuyerPaymentMethodCodeType:

Enumeration Values

Value Description
AmEx This enumeration value indicates that American Express is accepted for payment.
CashInPerson This enumeration value indicates that cash is accepted for payment. This option is generally only applicable to motor vehicle listings on the US and Canada sites.
CashOnPickup This enumeration value indicates that cash on pickup is accepted for payment.
CCAccepted This enumeration value indicates that credit cards are accepted for payment.

Note: This enumeration value is also returned in the response of order management calls if the seller is opted in to eBay Managed Payments, and the buyer used an eBay gift card to pay the full or partial balance of the order.
COD This enumeration value indicates that cash on delivery of item is accepted for payment.
CODPrePayDelivery Reserved for future use.
CreditCard This enumeration value is returned in the response of order management calls if the seller is opted in to eBay Managed Payments, and the buyer has paid for the order with any accepted payment method except an eBay gift card. If the buyer used an eBay gift card to pay the full or partial balance of the order, the CCAccepted value will be returned instead.

This is not an enumeration value that a seller would pass in as an accepted payment method.
CustomCode Reserved for internal or future use.
Diners This enumeration value indicates that the Diners Club credit card is accepted for payment.
DirectDebit This value indicates that a debit card can be used/was used to pay for the order. This payment method value must be passed in one of the Item.PaymentMethods fields if the seller is making the item available for eBay Now delivery. For eBay Now orders, the eBay Now valet accepts debit cards as a form of payment. This value is only applicable for eBay Now orders.
Discover This enumeration value indicates that Discover Card is accepted for payment.
Escrow Reserved for future use.
LoanCheck This enumeration value indicates that a loan check is accepted for payment. This option is generally only applicable to motor vehicle listings.
MOCC This enumeration value indicates that a money order or cashiers check is accepted for payment.
MoneyXferAccepted This enumeration value indicates that a direct transfer of money is accepted for payment.
MoneyXferAcceptedInCheckout This enumeration value indicates that a direct transfer of money during checkout is accepted for payment.
None This enumeration value indicates that no payment method has been specified for the listing. This may be the case for a classified ad listing, since payment happens outside of the eBay platform.
Other This enumeration value may be returned if the payment method is unknown.
OtherOnlinePayments This enumeration value may be returned if the payment method is unknown.
PaymentSeeDescription This enumeration value indicates that buyers should check the listing description for more details on payment. This may be the case for a classified ad listing, since payment happens outside of the eBay platform.
PayOnPickup PayOnPickup payment method. PayOnPickup is the same as CashOnPickup. For listings on the eBay US site, the user interface refers to this feature as Pay on pickup. In the user interface of your application, please refer to the feature as Pay on pickup so that the name in your user interface corresponds to the name on the eBay US site.
PayPal This enumeration value indicates that PayPal is accepted as a payment method. If PayPal is set by the seller as an accepted payment method, the seller must also supply their PayPal email address through the Item.PayPalEmailAddress field in an Add/Revise/Relist call.

If you don't pass PayPal in the listing request but the seller's eBay preferences are set to accept PayPal on all listings, eBay will add PayPal as a payment method for you in most cases, and we may return a warning.

Except for sellers opted in to eBay Managed Payments, PayPal must be the only accepted payment method to enable the immediate payment feature (Item.AutoPay). PayPal must be accepted for charity listings. PayPal must be accepted for event ticket listings when the venue is in New York state or Illinois, so that eBay can offer buyer protection (per state law). (For some applications, it may be simplest to use errors returned from VerifyAddItem to flag the PayPal requirement for New York and Illinois ticket listings.) PayPal must be accepted for US eBay Motors listings that require a deposit (and it will not be set automatically based on the seller's preferences). Conversely, if PayPal is specified for US eBay Motors listings, deposit attributes must be specified.
PayPalCredit This value indicates that a PayPal credit card can be used/was used to pay for the order.
PayUponInvoice This buyer payment method is only applicable for the Germany site and is associated with the rollout of Progressive Checkout and the Pay Upon Invoice feature. 'PayUponInvoice' is not a payment method that is offered to the buyer, but instead, eBay/PayPal makes the determination (based on several factors) during checkout whether the buyer is eligible for 'Pay Upon Invoice'. If the buyer is offered the 'Pay Upon Invoice' option, that buyer is not required to pay for the order until an order invoice is sent by the seller. The seller must offer PayPal as a payment option or the 'Pay Upon Invoice' option will not be made available to the buyer under any circumstance.

Only select categories on the Germany site will support the 'Pay Upon Invoice' option, and orders going above the two-thousand dollar EURO mark will not be eligible for 'Pay Upon Invoice'.

Since the seller can not specify 'Pay Upon Invoice' as a payment method, this enumeration value cannot be passed into a Item.PaymentMethods field in an Add/Revise/Relist call.
PersonalCheck This enumeration value indicates that a personal check is accepted for payment.
PostalTransfer Reserved for future use.
PrePayDelivery Reserved for future use.
VisaMC This enumeration value indicates that Visa or MasterCard are accepted for payment.
  * See the Enumeration Index to see exact use of each enumeration value in the API.