Անցնել բովանդակությանը
OneGate փաստաթղթեր
Կառավարման վահանակ
Ուղեցույցներ

Այս էջը հասանելի է միայն անգլերենով։ Կոդը, API դաշտերը և նույնացուցիչները չեն թարգմանվում։

Payments & lifecycle

A Payment is what you charge; Attempts are how the customer tried to pay.

A payment can have several attempts — for example a declined Idram attempt followed by a successful card attempt. The payment completes when one attempt succeeds.

Statuses

StatusMeaning
createdCreated; the customer has not started paying yet.
pendingWaiting for the customer to pay (also after a failed attempt, while they can retry).
processingThe provider is processing (e.g. crypto payment detected, awaiting confirmations).
requires_actionSomething needs attention, e.g. a crypto underpayment.
completedMoney was captured by your provider. Fulfil the order.
failedNo more attempts are possible.
expiredCheckout expired before payment.
cancelledYou cancelled a pending payment.
unknownThe provider did not answer. OneGate is reconciling — do not ask the customer to pay again.
partially_refunded / refundedRefunds completed.
A payment in failed, expired, cancelled or unknown can still move to completed if the provider later confirms the money was captured. OneGate always records provider truth; a timeout is never treated as a failure.

Order IDs

order_id is your reference. OneGate allows at most one active (non-failed, non-expired) payment per order to protect customers from double charges.

Metadata

Up to 50 keys (each up to 40 characters); values are strings up to 500 characters, numbers or booleans. Don't store sensitive personal data or card data in metadata.