So you added payments to your API. It works. The test card goes through. Postman is green. You are feeling like a fintech engineer. 😎
Then one evening the network gets slow.
Your server calls the payment provider. The provider charges the card. The answer is on its way back... and your request times out first.
Your code sees an error. So it does the "responsible" thing and retries.
The customer gets two debit alerts. 😭
And the customer is not sending you a nice message.
If you have ever stood at a POS stand in Lagos, you already know this story. You want to withdraw ₦5,000. The agent slots your card. The machine thinks... and thinks... "Transaction timed out". The agent says "Oga, let's try again". Machine prints a slip. Then your phone buzzes. Debit alert. Buzz again. Debit alert. 👀
The machine did not fail. It was just late with the answer. The second try was a brand new withdrawal.
That is exactly the bug we are fixing today.…