Payment sessions

A payment session is one checkout attempt.

Sessions can come from payment links, WooCommerce, hosted checkout, or direct API integration.

Payment sessions help merchants understand what happened before a transaction is final. A session can exist even when no payment has been completed yet.

Session states

1. Created
2. Pending
3. Processing
4. Paid
5. Failed
6. Expired
7. Refunded

What each state means

Created means Yera Connect created the checkout session but the customer has not completed payment yet.

Pending means payment has started or is waiting for provider confirmation.

Processing means the payment is being processed and may still need final confirmation.

Paid means the payment has been confirmed.

Failed means the checkout could not be completed successfully.

Expired means the checkout session is no longer valid.

Refunded means a paid transaction has been refunded or marked as refunded.

What merchants should review

Open a session to check the amount, currency, customer email, provider route, settlement asset, metadata, and linked transaction.

Also check:

1. Source, such as WooCommerce, payment link, hosted checkout, or API.
2. Created time.
3. Last updated time.
4. Customer return or callback URL.
5. Webhook delivery status.
6. Error message if checkout failed.

WooCommerce sessions

WooCommerce sessions include the WooCommerce order ID and order key in metadata so support can trace the order from Yera Connect back to WordPress.

How to use sessions for support

If a customer says they paid but the order did not update, search for the payment session first.

Then check:

1. Session status.
2. Linked transaction.
3. WooCommerce order metadata.
4. Webhook delivery result.
5. Provider error if payment failed.

The payment session ID is one of the most important references to send to support.