Payment methods
The payment method object and the allowed CRUD operations on the related resource endpoint
Last updated
The payment method object and the allowed CRUD operations on the related resource endpoint
Last updated
Payment methods represent the type of payment sources (e.g., Credit Card, PayPal, Apple Pay, etc.) offered in a market and/or store. They can have a price and must be present before placing an order.
A payment method must be associated with a payment gateway. The payment source type used with a payment method depends on the associated gateway.
The available payment method options when a store is in scope are defined by the payment methods enabled for the store only. If the store has no payment method enabled, the associated market's payment methods will be returned as the available payment methods for the store.
At the payment method level, you can set an option to configure when the order is placed upon asynchronous authorization:
Auto-place — set the auto_place
attribute to true
if you want your orders to be automatically placed as soon as we get a successful webhook from the payment gateway.
At the moment this option is available for , , , Satispay, , and .
At the payment method level, you can set a couple of options to configure at which step of the order lifecycle the payment capture is performed in your market(s):
Auto-capture — set the auto_capture
attribute to true
if you want payments to be automatically captured as soon as they are authorized. Add the auto_capture_max_amount_cents
value if you want the auto-capture option to be enabled only for orders under a certain amount.
Delayed capture — set the require_capture
attribute to false
if you want to start fulfilling your orders even if their payment is not captured yet and manually capture them when they’re ready to be shipped.