How to Start Ecom Transaction in Sbi

in ecommercepayments · 7 min read

Step-by-step guide for entrepreneurs to set up and run ecom transactions with State Bank of India payment gateway, including registration,

Overview

How to Start Ecom Transaction in Sbi Explains the Practical Steps Entrepreneurs and Business Owners Must Take to Accept Online Payments Through State Bank of India. This Guide Walks You From Merchant Registration and KYC to Sandbox Testing, Integration Code Samples, Going Live, and Settlement Processes. You Will Learn What Documents are Required, Which Credentials You Will Receive, How to Implement a Redirect or API-Based Payment Flow, and How to Validate Transactions and Reconcile Settlements.

Why this matters: SBI is one of the largest payment gateway providers in India. Correct setup reduces downtime, chargebacks, and reconciliation errors, and speeds up customer checkout conversion. Prerequisites: registered company/sole proprietorship, GSTIN, current account with SBI or supported bank, PAN, KYC documents, website or mobile app, developer access.

Overall time estimate: ~3 days to 2 weeks depending on KYC processing and developer availability.

Step 1:

Register merchant account (how to start ecom transaction in sbi)

Action: Apply for an SBI merchant payment gateway account via SBI merchant services or the SBI payment gateway portal.

Why youre doing it: Registration creates your merchant identity (Merchant ID / MID) and establishes contract terms, pricing, and settlement cycle. This is the legal and technical starting point.

  1. Visit the SBI merchant onboarding page or contact your relationship manager.
  2. Choose account type: payment gateway or State Bank Collect for e-commerce.
  3. Submit basic business details and contact info.

Expected outcome: You receive an application acknowledgement and instructions for KYC submission and technical onboarding.

Common issues and fixes:

  • Delay in approval: Follow up using the service ticket or RM contact provided.
  • Wrong account type chosen: Confirm product features with SBI support and request product change.
  • Missing contact details: Provide a dedicated technical contact email and phone.

Time estimate: ~10 minutes

Step 2:

Complete KYC and sign agreement

Action: Upload required KYC documents, sign merchant agreement, and set up settlement bank details.

Why youre doing it: SBI requires verified KYC for anti-fraud, compliance with RBI rules, and to enable settlements into your bank account.

  1. Gather documents: PAN, GST certificate, company incorporation, proof of address, cancelled cheque or bank mandate, director IDs.
  2. Upload via the SBI portal or send to the designated support email as instructed.
  3. Sign the merchant agreement (digital or physical) and confirm settlement account details.

Expected outcome: Merchant KYC accepted, merchant agreement executed, and account flagged for technical provisioning.

Common issues and fixes:

  • Document rejection: Check file format and clarity (PDF/JPEG), ensure signature pages are complete.
  • Settlement account mismatch: Provide a cancelled cheque or bank certificate matching your legal entity.

Time estimate: ~10 minutes

Step 3:

Receive credentials and access sandbox

Action: Obtain merchant credentials (Merchant ID, Terminal ID, access keys), and request sandbox or testing access.

Why youre doing it: Credentials allow API authentication and sandbox access lets you validate integration without real money.

  1. Expect an email with MID, TID, user credentials, and a link to developer/sandbox portal.
  2. Download the integration kit and read the API docs provided by SBI.
  3. Note endpoints for sandbox and production, hash or signature methods, and test card numbers.

Expected outcome: Working access to the sandbox environment with credentials and sample test data.

Common issues and fixes:

  • No sandbox details: Request the developer integration kit and explicit sandbox endpoints.
  • Credentials not working: Confirm you are using sandbox endpoints and correct environment flag.

Time estimate: ~10 minutes

Step 4:

Integrate payment gateway (redirect and API examples)

Action: Implement the checkout flow on your website or mobile app using SBI gateway integration method (hosted redirect or server-to-server API).

Why youre doing it: Integration allows customers to complete secure card/UPI/netbanking transactions and returns transaction status to your system for order processing.

  1. Choose a flow: Redirect (easy) or API/tokenization (advanced).
  2. Implement server-side order creation and signature/hash generation as documented.
  3. Handle callback/notify URL to update order status once gateway responds.

HTML redirect example (replace placeholders):

<form method="post" action="payments.sbi
 <input type="hidden" name="merchant_id" value="YOUR_MID">
 <input type="hidden" name="order_id" value="ORDER12345">
 <input type="hidden" name="amount" value="100.00">
 <input type="hidden" name="currency" value="INR">
 <input type="hidden" name="signature" value="GENERATED_SIGNATURE">
 <button type="submit">Pay Now</button>
</form>

Server-side status check example with curl (replace placeholders):

curl -X POST "payments.sbi \
 -H "Content-Type: application/json" \
 -d '{"merchant_id":"YOUR_MID","order_id":"ORDER12345","signature":"GENERATED_SIGNATURE"}'

Expected outcome: Customer is redirected to SBI payment page (or payment popup opens) and payment status is posted back to your notify URL.

Common issues and fixes:

  • Signature mismatches: Use the exact hashing algorithm and parameter order specified by SBI.
  • Callback not received: Ensure your server uses HTTPS and is publicly reachable; whitelist gateway IPs if required.
  • CORS or frontend errors: Move sensitive signing to server-side to avoid token exposure.

Time estimate: ~10 minutes

Step 5:

Test transactions in sandbox

Action: Run a full suite of sandbox transactions including success, failure, and timeout scenarios.

Why youre doing it: Testing prevents revenue loss, reduces failed orders, and verifies reconciliation logic before going live.

  1. Execute test transactions using sandbox test cards and UPI identifiers provided.
  2. Validate the callback payload, signature verification, order state transitions, and UI messages.
  3. Test edge cases: declined cards, 3D Secure flows, timeouts, duplicate payments, and refunds.

Expected outcome: Your system records correct payment statuses, displays accurate customer messages, and triggers order fulfillment only on confirmed payments.

Common issues and fixes:

  • Test cards failing: Confirm correct sandbox card numbers and expiry values.
  • 3D Secure popups blocked: Allow popups or implement the recommended 3DS flow.
  • Missing logs: Add detailed server-side logging for request/response payloads for debugging.

Time estimate: ~10 minutes

Step 6:

Move to production and go-live checklist

Action: Request production access from SBI, switch endpoints and credentials, and perform a limited live rollout.

Why youre doing it: Production transition enables real payments, settlement, and full customer use.

  1. Submit the checklist required by SBI: signed agreement, KYC verification, completed integration tests.
  2. Request activation of production MID and obtain production keys.
  3. Switch endpoints and perform 3-5 low-value live transactions to validate settlement.

Expected outcome: Production environment activated, transactions settle into your nominated bank account, and you can accept live payments.

Common issues and fixes:

  • Production keys not issued: Confirm all compliance items are complete and request RM escalation.
  • Live transactions failing: Compare production logs with sandbox, check IP whitelisting and certificates.

Time estimate: ~10 minutes

Step 7:

Set up reconciliation, settlements, and monitoring

Action: Configure settlement schedules, automatic reconciliation, and live monitoring/alerts.

Why youre doing it: Accurate reconciliation prevents accounting errors and ensures funds are tracked from transaction to settlement.

  1. Download sample settlement reports from SBI portal or subscribe to daily reports via email/SFTP.
  2. Build automated reconciliation that matches MID, order_id, amount, and transaction_id to your orders.
  3. Configure alerts for failed settlements, high decline rates, spikes in refunds, or suspicious activity.

Example reconciliation check (pseudo code):

  1. For each settlement record, find matching order by order_id and amount.
  2. If no match, mark for manual review and log the discrepancy.
  3. Aggregate daily totals and compare with bank deposit amounts.

Expected outcome: Automated daily reconciliation, timely detection of settlements issues, and clear accounting records.

Common issues and fixes:

  • Missing transactions in settlement: Verify settlement window and T+N processing time, and cross-check holdbacks or chargebacks.
  • Format mismatch in reports: Map fields in the report to your financial ledger and request a sample CSV header from SBI.

Time estimate: ~10 minutes

Testing and Validation

How to verify it works with checklist:

  1. Confirm sandbox payments return success and failure codes as expected.
  2. Verify signature/hash verification on all incoming callbacks.
  3. Run 3-5 low-value live transactions and confirm money reaches settlement bank within the scheduled cycle.
  4. Validate daily settlement report matches recorded orders and amounts.
  5. Test refunds and chargebacks in both sandbox and production.

Perform each check and mark pass/fail. If any item fails, capture logs, compare with SBI sample payloads, and contact SBI technical support with transaction IDs for trace.

Common Mistakes

  1. Missing or incorrect signature/hash implementation causes rejected callbacks - always follow parameter order and hashing algorithm documented by SBI.
  2. Testing on production endpoints - use sandbox credentials until production keys are issued to avoid real charges and disputes.
  3. Not handling asynchronous notifications - ensure your notify URL updates order status on callback, not only after redirect.
  4. Poor reconciliation mapping - always use a unique order_id and store the gateway transaction_id for matching settlement reports.

Avoid these by following the integration checklist, storing raw payloads for debugging, and automating reconciliation.

FAQ

How Long Does It Take to Start Ecom Transaction in Sbi?

Most basic merchant accounts can be provisioned in 3 to 10 business days after KYC and agreement submission. Integration and testing typically take 1 to 7 days depending on developer resources.

Do I Need an SBI Current Account to Use Their Gateway?

No, SBI often supports settlements to other banks, but some pricing or features may favor SBI accounts. Confirm settlement bank options when registering.

How Do I Handle Refunds and Settlements?

Use the refund API or portal provided by SBI. Reconcile refund IDs with original transaction IDs and monitor settlement reports for refunded amounts.

What If My Sandbox Tests Pass but Production Fails?

Compare environment differences: production keys, endpoint URLs, TLS certificates, IP whitelists, and signature methods. Enable verbose logging and contact SBI support with transaction IDs.

Are There PCI Compliance Requirements?

Yes. If you handle card data directly, you must comply with PCI-DSS. Use hosted payment pages or tokenization to minimize PCI scope.

Next Steps

After completing this guide, configure production monitoring, set up automated daily reconciliation, and train customer support on payment workflows and common failure codes. Plan a phased rollout with analytics to track conversion improvements and payment decline rates. Regularly review settlement reports and engage with SBI relationship managers to optimize pricing and features.

Further Reading

Sources & Citations

Marcus

About the author

Marcus — Ecommerce Development Specialist

Marcus helps entrepreneurs build successful ecommerce stores through practical guides, platform reviews, and step-by-step tutorials.

Launch Your Ecommerce Store for Just $1

Build your professional ecommerce store with Shopify - get all the tools, templates, and support needed to launch and grow your online business successfully.

Try Shopify for just $1/month for your first 3 months