Payment types and statuses
Understand payment states and types to implement correct business logic
When dealing with payments, it is crucial to differentiate between an order and a transaction as they have distinct meanings and implications.
Solidgate order logs are stored for 30 days.
An
order
is essentially a customer’s request to purchase goods or services, which serves as a record of a planned purchase. In Solidgate, an
order
and its associated
transaction
go through different stages, each of which helps move through the payment processing steps, from initiation and verification to the final state - approval, rejection, or settlement.
Order status
Value |
Final State |
Description |
created
|
No
|
This is the initial state of an order, indicating its creation. It remains in this state until a payment attempt occurs. |
processing
|
No
|
An order enters this state when payment is first attempted and stays here until a payment is captured. |
3ds_verify
|
No
|
This state is for orders undergoing 3D Secure verification, either triggered by a payment request with a 3D parameter or additional verification by Solidgate or the issuing bank. |
settle_pending
|
No
|
This state applies to payment methods such as iDeal/Sofort, where the payment is confirmed but not yet credited to the merchant's account. |
auth_ok
|
No
|
Indicates successful reservation of funds for the transaction. |
auth_failed
|
Yes
|
This state indicates a failure in reserving funds. |
void_ok
|
Yes
|
The reservation of funds has been voided. |
approved
|
Yes
|
The order is approved, and the payment is successfully processed. |
declined
|
Yes
|
The order was declined. |
settle_ok
|
Yes
|
Reserved funds have been successfully captured. |
partial_settled
|
Yes
|
A portion of the funds has been captured. |
refunded
|
Yes
|
Funds by the order were transferred back to the cardholder. |
The final state denotes whether an order can remain in that state until subsequent actions such as void or refund, as part of logical system processing.
|
Transaction status
Value |
Description |
created
|
The transaction was created. |
processing
|
The transaction is currently undergoing processing. |
verify
|
The transaction is going through 3DS verification. Redirect the customer to the ACS URL provided in response to finalize the payment. |
settle_pending
|
The payment has been confirmed but not yet credited to the merchant's account. This logic applies only to iDeal/Sofort payment methods. |
fail
|
The transaction has been rejected. Refer to the decline code for additional information. |
success
|
The transaction has been successfully processed. |
Transaction type
Value |
Description |
pay
|
The operation of charging, which includes authorization and capture in a single transaction. |
recurring
|
The operation of executing payments using a token for repeated transactions. |
recurring-auth
|
The operation of reserving funds using a token. |
refund
|
The operation of transferring funds back to the cardholder. |
resign
|
The operation of executing payments using a token in conjunction with CVV. |
resign-auth
|
The operation of reserving funds using a token and CVV. |
auth
|
The operation of reserving funds. |
settle
|
The operation of settling reserved funds. |
void
|
The operation of cancelling a reserved fund. |
apple-pay
|
The charge via Apple Pay. |
google-pay
|
The charge via Google Pay. |