For the complete documentation index, see llms.txt. This page is also available as Markdown.

Payment Retires

1. What is changing with the new Payment Retries feature?

To reduce user friction and increase conversion rates, users will soon be able to retry failed transactions directly on our fail page, without restarting the purchase flow.

2. Do we need to do any development work to support this?

No, this feature is automatically available for all Codapay, Codashop, and Coda Webstore users. It requires no development work on your end.

3. Will we receive a Notify Callback for every single failed retry attempt?

No. Coda will only send a callback in two scenarios to prevent spamming your system:

  • Success: If any attempt succeeds, we will share a success status.

  • Definitive Failure: If the transaction definitively fails (e.g., the user exceeds their retry limit, the session times out, or fails on all attempts), we will share the latest failed transaction status.

4. What status will the Inquiry API return if the user is actively retrying?

If you check the status of a Transaction ID and the user still has retries left and the time limit has not expired, the Inquiry API will return a "Pending" status.

5. How many retries does a user get, and how long do they have?

By default, users are allowed a maximum of 5 retries and have 60 minutes after the initial transaction to attempt another retry. The time to complete the transaction remains the same, based on the payment channel selected.

6. What do users see when a payment fails?

Users will see a failure page with a contextual error message based on the failure reason (e.g., "Insufficient wallet balance, please top up and retry") and a "Retry payment" button. They can also choose to return to your game or title page. Users who are blocked for fraud or other reasons will not be able to retry their payment.

7. Will users be able to switch payment channels when retrying?

Not in the initial phase. Payment channel switching will be introduced in a later phase, with availability targeted before the end of 2026. When we roll out the payment channel switching feature, we will share further details and implications.

8. How will this affect our daily transaction reports and settlement?

Settlement and Order Accounting will continue using the transaction ID. Your Daily, Weekly, Monthly, and Custom Date Transaction Reports will still use Transaction ID. To enable publishers to track “attempts”, we will add a new report to the publisher portal, accessible via “transactions tab” > “more filters” > “payment details” > “all transaction attempts”.

9. How will conversion rate reporting change?

Conversion rate will still be calculated as the: Successful Transactions / Initiations.

10. What should we do when we receive a "Pending" status?

Do not grant items or mark the order as failed when you receive a Pending status. Wait for the final webhook notification. You can also use the Inquiry API to poll for the latest status.

Last updated

Was this helpful?