Payment methods
The payment method object and the allowed CRUD operations on the related resource endpoint
Last updated
API reference
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.
A payment method that is not already associated with a market or a store can be set as the for one or more markets. To do that:
Create a new payment method and keep it as more generic as possible by setting the required parameters only:
name
currency_code
price_amount_cents
payment_source_type
payment_gateway
Now you can set that payment method as the default for one or more markets as long as they are associated with a price list in the same currency.
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 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.
At the moment this option is available for , , , Satispay, , and .
Check the related for any additional info on how to set up auto-capture for your orders.