{"id":1051,"date":"2026-11-16T13:46:28","date_gmt":"2026-11-16T08:16:28","guid":{"rendered":"https:\/\/smppcenter.com\/kb\/?p=1051"},"modified":"2026-11-16T13:46:31","modified_gmt":"2026-11-16T08:16:31","slug":"payment-gateway-integration-overview","status":"publish","type":"post","link":"https:\/\/smppcenter.com\/kb\/payment-gateway-integration-overview\/","title":{"rendered":"How Online Recharge Works: From Checkout to Wallet Credit"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Manual top ups do not scale. Every one of them is an email, an invoice, a bank transfer to chase and someone on your team adding credits by hand, usually after the customer&#8217;s campaign has already stalled. Online recharge removes that: the customer buys a pack, pays, and the wallet credits itself.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">The flow, step by step<\/h3>\n\n\n\n<ol class=\"wp-block-list\">\n<li>The customer picks a credit pack, a currency and a tax inclusive price from your panel.<\/li>\n\n\n\n<li>Checkout runs on the merchant account belonging to you or to the reseller who owns that customer.<\/li>\n\n\n\n<li>The gateway confirms the payment through a signature checked webhook.<\/li>\n\n\n\n<li>Credits post according to the pack, along with any bonus and tax handling you configured.<\/li>\n\n\n\n<li>Every recharge is written to the credit usage log with the payment reference, amount, pack and the resulting balance.<\/li>\n\n\n\n<li>The same wallet then pays for SMS, WhatsApp, RCS or voice under the account&#8217;s rate cards.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">The important bit is step 3. Pending, failed and cancelled payments never touch the wallet. Credits post only on a gateway confirmed success, so a customer cannot abandon a checkout and still get credit.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">What you have to set up before any of it works<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Credit packs.<\/strong> SMS, WhatsApp, RCS or mixed credits, with optional bonus credits. See the pricing packs article for how to build a sensible ladder.<\/li>\n\n\n\n<li><strong>Pricing and tax.<\/strong> Display price, GST or VAT treatment, and the checkout currency.<\/li>\n\n\n\n<li><strong>Gateway keys.<\/strong> Merchant ID, API key and webhook secret, stored against the owning admin or reseller.<\/li>\n\n\n\n<li><strong>Audit trail.<\/strong> Already handled for you, but know where it is, because it is what you use in a dispute.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Get the packs right before you turn the gateway on. A live checkout pointing at a half built pack catalogue is how customers end up buying something you did not intend to sell.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Which gateways<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Several come as plugins with the platform, including PayPal, Cashfree, PhonePe, MPESA and EBS Ingenico. Beyond those, the integration is not tied to a fixed list. Any gateway that offers a checkout URL plus a signed webhook or IPN can be wired, which covers the usual Indian options such as Razorpay, PayU, CCAvenue, Paytm and Instamojo, international processors such as Stripe, Braintree, Authorize.net, Adyen, Mollie and 2Checkout, and regional ones such as Paystack and Flutterwave.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Pick on settlement terms and local payment methods in your market, not on brand. Which methods your customers actually see (UPI, cards, net banking, wallets) depends entirely on the gateway you wire.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Two protections worth knowing<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Idempotency.<\/strong> The same gateway payment ID cannot credit twice. Webhooks get retried in the real world, and without this a retry would double credit the customer.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Keys are per tenant.<\/strong> Merchant credentials are stored against the admin or reseller that owns them and are not shared across tenants. Webhook signatures are verified before any credit posts.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Reconciling it<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Match gateway settlements against the credit logs on a regular cycle, the same way you match vendor invoices against your billing summary. Two things to look for: payments that settled but show no matching credit, and credits with no matching settlement. Both are rare, and both are expensive if they run for a month unnoticed.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Related articles<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/smppcenter.com\/kb\/pricing-categories-packs-online-recharge\/\">How to Set Up Pricing Categories and Packs for Online Recharge<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/smppcenter.com\/kb\/reseller-own-payment-gateway\/\">Letting Resellers Collect Payments With Their Own Gateway<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/smppcenter.com\/kb\/offline-payments-bank-details\/\">Offline Payments: When Customers Pay You Directly<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/smppcenter.com\/kb\/credit-vs-wallet-billing-model\/\">Credit or Wallet: Choosing the Right Billing Model<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/smppcenter.com\/kb\/reconcile-user-billing-discrepancies\/\">How to Reconcile User Billing and Spot Discrepancies<\/a><\/li>\n\n\n\n<li><a href=\"https:\/\/smppcenter.com\/kb\/faq\/does-your-app-support-online-sms-recharge-with-third-party-payment-gateway\/\">Does your app support online SMS recharge with third party payment gateway?<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>The full path a customer payment takes before credits land in a wallet, what has to be configured first, and why only a confirmed webhook moves the balance.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[349],"tags":[524,525,374,179,523,322],"class_list":["post-1051","post","type-post","status-publish","format-standard","hentry","category-billing-pricing-wallet","tag-credit-packs","tag-idempotency","tag-online-recharge","tag-payment-gateway","tag-wallet-auto-credit","tag-webhook"],"_links":{"self":[{"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/posts\/1051","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/comments?post=1051"}],"version-history":[{"count":0,"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/posts\/1051\/revisions"}],"wp:attachment":[{"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/media?parent=1051"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/categories?post=1051"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/smppcenter.com\/kb\/wp-json\/wp\/v2\/tags?post=1051"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}