---
title: "Payments"
description: "Learn what a KOMOJU payment resource is, the six payment statuses (including the two meanings of \"authorized\"), and how payment details represent method-specific data."
url: "https://docs.priv.staging.komoju-dev.tools/en/docs/introduction/payments"
source_url: "https://docs.priv.staging.komoju-dev.tools/en/docs/introduction/payments.md"
language: en
last_modified: "2026-03-26"
---

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 is documented in the [Payment: Show API reference](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/payments/GET/payments/%7Bid%7D).

# Payment Statuses

Payments have a read-only `status` field that tells you whether or not money has been collected.

| Status | Meaning |
| --- | --- |
| `pending` | A payment has been initiated but not confirmed. Pending payments await customer action. |
| `authorized` | See [The two meanings of authorized](https://docs.priv.staging.komoju-dev.tools/#the-two-meanings-of-authorized) below. |
| `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. |

## The two meanings of authorized

The `authorized` status has two possible meanings, depending on the payment method:

1. **Long-form async payment methods** (`konbini`, `bank_transfer`, `payeasy`) — the payment is reserved but awaiting customer action (e.g. waiting for the customer to go to the store and pay cash).
2. **All other payment methods** — `authorized` refers to a credit card authorization. The funds are in your control but haven't left the customer's account yet. These authorized payments are awaiting merchant action (e.g. the merchant performs a manual capture when goods are shipped). See [Two-Step Capture](https://docs.priv.staging.komoju-dev.tools/en/docs/development/advanced-payments/two-step-payments.md) for details.

# Payment details (advanced integrations only)

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 and expiration date, while a `konbini` payment needs to know which store the customer will pay at. This information is all "payment details".

In the API, `payment_details` is used when:

- [Creating payments](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/payments/POST/payments)
- [Paying for sessions](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/sessions/POST/sessions/%7Bid%7D/pay)
- [Creating tokens](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/tokens/POST/tokens)
- [Creating customers](https://docs.priv.staging.komoju-dev.tools/en/api-reference#2025-01-28/tag/customers/POST/customers)

If you are using [Hosted Page](https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/web-integrations/introduction-to-hosted-page.md) or [Hosted Fields](https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/introduction-to-hosted-fields.md), _you do not need to interact with payment details_. For a full reference of payment method-specific fields, see [Payments API | Payment Details](https://docs.priv.staging.komoju-dev.tools/en/docs/integration-guides/payments-api-payment-details.md).