No matter how you integrate KOMOJU, you will interact with payments either directly or indirectly. Even integrations using our e-commerce plugins like Shopify and WooCommerce create payments under the hood, and those payments can be queried and interacted with via our API.
A payment represents money collected from one of your customers. At a minimum, every payment has an amount and currency. The full list of attributes can be found on Payment: Show.
Payments have a read-only
status field that tells you whether or not money has been collected.
|pending||A payment has been initiated but not confirmed. Pending payments await customer action.|
|authorized||Two possible meanings, depending on the type of payment.|
1. For long-form async payment methods (konbini, bank_transfer, payeasy), authorized payments are reserved but awaiting customer action (e.g. waiting for customer to go to the store and pay cash).
2. For all other payment methods, authorized refers to credit card authorization. This is where the funds are in your control, but haven't left the customer's account yet. These authorized payments are awaiting merchant action (e.g. merchant performs a manual capture when goods are shipped).
|captured||Payment was successful. The money will be transferred to your bank account next settlement.|
|refunded||The payment was completed, but has been fully refunded. Note that partially refunded payments remain captured.|
|cancelled||The payment was actively cancelled by either the merchant or the customer.|
|expired||Payment was pending or authorized with no action for too long.|
In KOMOJU we use the term "payment details" (
payment_details in the API) to refer to any information specific to one payment method. For example, a credit card payment has the card number, expiration date, etc, while konbini payments need to know which store the customer will pay at. This information is all "payment details".
In the API,
payment_details is used for