Retry Strategy and Grace Period Handling for Failed Transactions

Overview

For the External Billing payment method, MarketONE provides the capability to retain a customer by not canceling their subscription upon initially failed renewals transactions. MarketONE allows Merchants to configure the retry strategy to keep the subscription active on the platform for the opportunity to recover the payment before the grace period ends. For successful transactions, Resellers (Service Providers) do not need to send any response, and the transaction status is captured. A retry strategy is triggered when a Reseller sends an error response on a transaction to MarketONE.

Retry Strategy

Definition	Configuration Setting	Example
Retry Duration	The time span between subsequent retry attempts. First retry attempt: X days after the initial failure. Subsequent attempts: X days after previous retry.	MERCHANT_OPTIONS :CASHBOX_FIRST_RETRY_DAYS	1 Day
		MERCHANT_OPTIONS :CASHBOX_OTHER_RETRY_DAYS	2 Days
Retry Attempts	Number of attempts upon receiving a soft error on a transaction. MarketONE will retry until the attempts run out. MarketONE will not make subsequent attempts if no response is received.	MERCHANT_OPTIONS : CASHBOX_MAX_RETRIES	3 Days
	The retry number will be included in the transaction object under metadata.		`"metadata": [ "value": "2", "name": "vin:RetryNumber" } ]`

Grace Period

Definition	Configuration Setting	Example
Grace Period is the total amount of time an entitlement will remain active in MarketONE before the subscription is canceled for non-payment. The grace period kicks in after initial billing attempt.The grace period is independent from the retrial mechanism: stopping the retries does not automatically cancel the subscription. If the grace period is set to 0, no retry will happen. If the grace period is less than the retry, the subscription will cancel. It will not attempt all retries. The grace period can be set in two ways: Merchant configuration, and overriding the Merchant configuration by defining the grace period on the billing plan.	MERCHANT_OPTIONS : CASHBOX_EXPIRATION_OFFSET	7 Days

Error Codes

Definition	Configuration Setting	Example
Return codes received from the external payment processor can be categorized either as “Soft-Error” or “Hard-Error”.Soft-Error represents payments that may be recoverable by MarketONE. Soft-Fail error codes are subject to the retry processing. A soft error indicates a possible fix, the system keeps trying. The subscription will be canceled and disentitled after grace period ends. Hard-Error represents payments that cannot be recovered. A Hard Error can’t be fixed by a simple retry. The system stops trying. The subscription will be canceled and disentitled after the grace period ends.	The soft error and hard error code should be defined in the MarketONE Pre-Onboarding Questionnaire from a Reseller (Service Provider). The value is used to while configuring the Merchant in MarketONE.	”Error_Code”: “Soft""Error_Code”: “Hard”

Uses Cases

Soft Error - Cancellation After Grace Period

Hard Error - Cancellation After Period

Sample

Error Type	Error Details	Reason / Intermediate Status	Final State
File Transfer Error	`[ { "id":"999", "vid":"999", "TRX_index":"999", "error_Code":"999", "file_Name":"VNDC_CHARGES_20210428013221.JSON" } ]`	This type of error should be returned to MarketONE if the consumer system couldn’t read the charge injection file due to a corrupted charge injection file, an incomplete transfer of the charge injection file, or a parsing error with the charge injection file. Expected values: - Billing_state: Good Standing - Autobill_state: Active	MarketONE will send the transactions again in a new charge injection file.
Soft Error	`{ "id":"AMD100001632", "Vid":"3d4848f8a30f3877d6fff0f6738b7748845c23ad", "TRX_index":"1", "Error_Code":"Soft" }`	The external payment processor manages the payment method of the end customer. The reason for the soft error can be temporary suspension because a change in payment details is needed. Returning a soft error means that the Reseller (Service Provider) still has a chance to collect payment from the customer. Expected values: - Billing State: In Retry / Grace Period/Unknown/Unusable PaymentMethod - Subscription State: Active	MarketONE will retry again. MarketONE will cancel the subscription when the grace period ends (that is, the subscription end date has passed).State when subscription is canceled: - Billing State: Failed to collect - Subscription State: Canceled
Hard Error	`{ "id":"AMD1000013234", "Vid":"3d4848f8a30f3877d6fff0f6738b7748845c23ad", "TRX_index":"1", "Error_Code":"Hard" }`	The reason for a Hard error can be account termination due to a failed payment method. Returning a hard error means that the Reseller (Service Provider) has no chance to collect payment from the customer. Expected values: - Billing State: Grace Period/Unusable PaymentMethod - Subscription State: Active	No Retry Attempts. MarketONE will cancel the subscription when the grace period ends (that is, the subscription end date has passed).State when subscription is canceled: - Billing State: Failed to collect - Subscription State: Canceled

Home

Introduction

For Merchants

For Resellers

Partner Ecosystem Management

Commerce Engine

Storefront Experience

APIs

Overview

Retry Strategy

Grace Period

Error Codes

Uses Cases

Sample

​Overview

​Retry Strategy

​Grace Period

​Error Codes

​Uses Cases

​Sample

Overview

Retry Strategy

Grace Period

Error Codes

Uses Cases

Sample