Payment Statuses

Every Payment Intent has a status field that tracks its lifecycle.

Statuses

Status	Meaning
INITIALIZED	Payment intent created, awaiting customer payment.
PROCESSED	Payment successful — funds will settle to your account.
FAILED	Payment failed (card declined, insufficient funds, etc.). Customer may retry.
REFUNDED	Payment was refunded after being processed.

Lifecycle

INITIALIZED → PROCESSED (success)
INITIALIZED → FAILED (decline/error)
PROCESSED  → REFUNDED (refund issued)

• A Payment Intent starts as INITIALIZED when created.
• After the customer completes payment on the hosted page, it transitions to PROCESSED.
• If the payment is declined or fails, it transitions to FAILED. The customer can retry from the payment page.
• A processed payment may later transition to REFUNDED if a refund is issued.

Checking status

You can check the current status of a Payment Intent at any time:

GET /api/v1/payments/intent?payment_intent_lookup_id=pi_abc123def456

Include your secret key in the Authorization header. This is useful for reconciliation but should not be your primary notification method — use webhooks or callbacks instead.