Information

In the following part of documentation you will find a supportive information for easy integration with SolidGate. 

Error codes

Orders status

 

Value	Description
created	The order was created
processing	The order is in processing
3ds_verify	The order goes through 3DS verification
approved	The order is approved and the payment is successful
declined	The order was declined
refunded	Funds by the order were transferred back to the cardholder
auth_ok	Funds were successfully reserved
auth_failed	Reservation of the funds is failed
settle_ok	Funds were successfully settled
void_ok	Operation of fund reservation was voided
partial_settled	Part of the funds was successfully settled

Status of transactions

Value	Description
created	The transaction was created
fail	An error processing the transaction
processing	The transaction is in processing
success	Transaction successfully processed
verify	The transaction is going through 3DS verification

Types of transactions

Refund reasons

Refund reason codes are provided for both Void and Refund operations. You could use them for the analysis of the return structure or trigger specific events on your side.

Disputes

Disputes are the general term for actions that are performed by a user to cancel the transaction without interacting with the merchant. 

Retry Strategies

Solid provides a feature of smart retrying failed subscriptions payments, which helps our merchants to recover revenue and decrease the involuntary churn rate of the customers.

How does it work?

After the initial collection of the invoice is failed, the retry mode would turn On, and the state of the subscription would change to "redemption".

While the subscription is in state "redemption", we would retry the invoice collection four times. The interval between the retries is based on the customer, payment method and card data features.

Moreover, we provide the option to automatically apply a Discount in % if we receive a decline "Insufficient Funds" during the last payment attempt.

How could you configure it?

You could select the predefined retry strategies in the Hub while creating or editing Subscription Product details.

The description of all available retry strategies is provided below.

#1 Retry Strategy for Weekly Subscription

Name in Hub: "#1 - Weekly 0% /0% /0% /0%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	2 days after the previous retry	-
4	5 days after the previous retry	-

#2 Retry Strategy for Weekly Subscription 25% Discount on the last retry

Name in Hub: "#2 - Weekly 0% /0% /0% /25%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	2 days after the previous retry	-
4	5 days after the previous retry	25%

#3 Retry Strategy for Weekly Subscription 50% Discount on the last retry

Name in Hub: "#3 - Weekly 0% /0% /50% /0%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	2 days after the previous retry	50%
4	5 days after the previous retry	-

#4 Retry Strategy for Weekly Subscription 75% Discount on the last retry

Name in Hub: "#4 - Weekly 0% /0% /0% /75%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	2 days after the previous retry	-
4	5 days after the previous retry	75%

#5 Retry Strategy for Weekly Subscription 3-25%,  4 - 50%

Name in Hub: "#5 - Weekly 0% /0% /25% /50%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	2 days after the previous retry	25%
4	5 days after the previous retry	50%

#6 Retry Strategy for Weekly Subscription 1-10%, 2 - 25%, 3 - 50%, 4 - 75%

Name in Hub: "#6 - Weekly 10% /25% /50% /75%"

#	Retry Interval	Discount
1	1 day after initial collection	10%
2	On the nearest Friday	25%
3	2 days after the previous retry	50%
4	5 days after the previous retry	75%

#7 Retry Strategy for Weekly Subscription 1 - 25%, 2 - 50%, 3 - 75%,  4 - 75%

Name in Hub: "#7 - Weekly 25% /50% /75% /75%"

#	Retry Interval	Discount
1	1 day after initial collection	25%
2	On the nearest Friday	50%
3	2 days after the previous retry	75%
4	5 days after the previous retry	75%

#8 Retry Strategy for Weekly Subscription 2 - 15%, 3 - 40%,  4 - 65%

Name in Hub: "#8 - Weekly 0% /15% /40% /65%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	15%
3	2 days after the previous retry	40%
4	5 days after the previous retry	65%

#9 Retry Strategy for Monthly Subscription w/o Discounts

Name in Hub: "#9 - Monthly 0% /0% /0% /0%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	9 days after the previous retry	-
4	19 days after the previous retry	-

#10 Retry Strategy for Monthly Subscription with 25% Discount on the last retry

Name in Hub: "#10 - Monthly 0% /0% /0% /25%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	9 days after the previous retry	-
4	19 days after the previous retry	25%

#11 Retry Strategy for Monthly Subscription with 50% Discount on the last retry

Name in Hub: "#11 - Monthly 0% /0% /0% /50%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	9 days after the previous retry	-
4	19 days after the previous retry	50%

#12 Retry Strategy for Monthly Subscription with 75% Discount on the last retry

Name in Hub: "#12 - Monthly 0% /0% /0% /75%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	9 days after the previous retry	-
4	19 days after the previous retry	75%

#13 Retry Strategy for Monthly Subscription 3 - 25%, 4 - 50%

Name in Hub: "#13 - Monthly 0% /0% /25% /50%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	9 days after the previous retry	25%
4	19 days after the previous retry	50%

#14 Retry Strategy for Monthly Subscription 2 - 25%, 3 - 50%, 4 - 75%

Name in Hub: "#14 - Monthly 0% /25% /50% /75%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	25%
3	9 days after the previous retry	50%
4	19 days after the previous retry	75%

#15 Retry Strategy for Monthly Subscription 1 - 25%, 2 - 50%, 3 - 50%, 4 - 75%

Name in Hub: "#15 - Monthly 25% /50% /50% /75%"

#	Retry Interval	Discount
1	1 day after initial collection	25%
2	On the nearest Friday	50%
3	9 days after the previous retry	50%
4	19 days after the previous retry	75%

#16 Retry Strategy for Monthly Subscription 2 - 15%, 3 - 40%, 4 - 65%

Name in Hub: "#16 - Monthly 0% /15% /40% /65%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	15%
3	9 days after the previous retry	40%
4	19 days after the previous retry	65%

#17 Retry Strategy for Monthly Subscription 4 - 30%

Name in Hub: "#17 - Monthly 0% /0% /0% /30%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	9 days after the previous retry	-
4	19 days after the previous retry	30%

#18 Retry Strategy for Monthly Subscription 3 - 50%

Name in Hub: "#18 - Monthly 0% /0% /50% /0%"

#	Retry Interval	Discount
1	1 day after initial collection	-
2	On the nearest Friday	-
3	9 days after the previous retry	50%
4	19 days after the previous retry	-

Cards for test payments