[
{
"title":"Testing",
"link":"https://docs.solidgate.com/payments/testing/",
"text":"Simulate payments to test your integration before launching in production.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-customizable.svg"
}
,
{
"title":"Create your payment form",
"link":"https://docs.solidgate.com/payments/integrate/payment-form/create-your-payment-form/",
"text":"Understand how to integrate the payment form into your product.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-payments.svg"
}
,
{
"title":"Billing",
"link":"https://docs.solidgate.com/billing/",
"text":"Smart billing solutions designed for diverse business models.",
"imgSrc":"https://solidgate.com/wp-content/uploads/2022/06/icon-global.svg"
}
]
Efficiently manage card payments and monitor key payment statuses in real-time
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 the last 60 days.
Contact Solidgate support if you need information about older data.
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.
Solidgate offers
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.
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_cvv is provided with the
moto
payment type
either card_cvv nor payment_type is 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
Guide
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.
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.