When dealing with payments, it is crucial to differentiate between an order and a transaction as they have distinct meanings and implications.
An order is 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 the stages helps move through the payment processing steps, from initiation and verification to the final state - approval, rejection, or settlement. Solidgate supports a variety of payment_type , including 1-click, recurring, retry, installments, rebill, and MOTO (Mail Order/Telephone Order) transactions.
- Guide
The card orders report provides comprehensive insights into transaction processing and customer data, allowing merchants to optimize financial tracking and operational strategies. reporting solution for detailed transaction data, order status tracking, and actionable insights into customer behavior - Guide
Payments analytics in the Payments section provides a comprehensive view of payment performance, critical for assessing overall payment operations health. payments analytics with insights into gross volume, approval rates, declines, and transaction risks to optimize payment processes and improve customer experience
Order status
| Value | Final state | Description |
|---|---|---|
| processing | No | An order enters this state when payment is first attempted and stays here until 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. |
| 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. |
| 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
Guide The refund involves coordination between the merchant, Solidgate, and the acquirer for successful processing. 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 |
|---|---|
| processing | The transaction is currently undergoing processing. |
| verify | The transaction is undergoing 3D Secure verification, and the customer should be redirected to the ACS URL provided to finalize the payment. |
| success | The transaction has been successfully processed. |
| fail | The transaction has been rejected. Refer to the
Guide Understand why the payment is declined and how you can resolve it. error code for additional information. |
Transaction type
| Value | Description |
|---|---|
| recurring-auth | The operation of reserving funds using a token. |
| refund | The operation of transferring funds back to the cardholder. |
| 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. |
Payment type
| Value | Description | |
|---|---|---|
| 1-click | CIT | Customer-initiated transaction. |
| recurring | MIT | Subscription-based merchant-initiated transaction. |
| retry | MIT | Reattempt of a merchant-initiated transaction. |
| installment | MIT | Merchant-initiated debit method for credits and installments. |
| rebill | MIT | An unscheduled withdrawal by a merchant triggered under certain conditions. |
| moto | CIT | Mail Order/Telephone Order transaction (MOTO) is a type of card-not-present (CNP) payment where customers provide their payment details to the merchant through email, post, fax, or telephone. |
Payment gets declined if
card_cvvis provided with the moto payment type- either
card_cvvnorpayment_typeis provided
Highly recommended to specify the scheme_transaction_id with stored card details, taken from the first PSP transaction, for transactions such as
recurring
,
retry
,
installment
, or
rebill
as it proves the linkage between MITs and the initial CIT by referencing the scheme_transaction_id value from that CIT in all subsequent MITs.
1-click
Payment type 1-click can trigger 3D Secure
Guide
Boost payment security with 3D Secure support.
(3DS)
force3ds
true
verification, which requires additional authentication by displaying the bank’s ACS URL.
Also, you should know that
Guide
Improve your checkout conversion by accepting payments via Apple Pay.
Apple Pay
and
Guide
Improve your checkout conversion by accepting payments via Google Pay.
Google Pay
do not support 1-click payment type according to Payment System Rules, so it is recommended redisplaying
Guide
Create a custom payment form for a personalized experience.
payment buttons
for upsells on the checkout screen.
Webhooks
Subscribe for events on your Solidgate account so your integration can automatically trigger actions. Webhooks notify merchants in real-time about updated card order Webhook changes, such as refund , void , and settle types. Set up and manage events API by creating endpoints, listing them, updating, or deleting.
Receive notifications when created network token Webhook or updated network token Webhook by Visa or Mastercard. Real-time alerts for received dispute Webhook , received prevention alert Webhook , and received fraud alert Webhook allow to manage risk effectively.
Track updates
After the payment data is processed, if the bin of an American card is provided, you should expect the returned address parameters to contain American address data. This includes details such as the country, city, state, and zip code associated with the card’s BIN.
If the data is bound by strict logic, consider including this information in the order_metadata object to ensure that all necessary billing details are provided and facilitate further processing.