Getting Started with ZezoPay

To begin, register your merchant account on the ZezoPay platform:

1. Visit the ZezoPay Platform.
2. Register Your name, business email, and administrative credentials.
3. Open your Merchant Dashboard to manage payment routing, API keys, and transactions.

Your backend application uses these credentials to authenticate API requests with ZezoPay:

1. In the dashboard, navigate to Settings → API Keys.
2. Click on Generate API Key (Public Key) and Generate Secret Key.
3. Add them to your application's environment configuration:

   env

   Copy

   ZEZOPAY_PUBLIC_KEY=zp_pub_xxxxxxxxxxxxxxxxxxxx
   ZEZOPAY_SECRET_KEY=zp_sec_xxxxxxxxxxxxxxxxxxxx

ZezoPay connects to your payment gateway accounts. Store your gateway credentials in ZezoPay's encrypted vault:

1. Go to Settings → Payments in the dashboard.
2. For Razorpay: Enter your Razorpay Key ID and Key Secret from your Razorpay Dashboard.
3. For Stripe: Enter your Stripe Secret Key (starts with sk_live_ or sk_test_) from the Stripe API Keys Dashboard.
4. For PhonePe / CCAvenue: Enter your Merchant ID, Salt Key, and Salt Index.
5. Click Save Settings to encrypt and store your credentials.

Webhooks allow ZezoPay to receive real-time transaction updates directly from payment processors.

1. Razorpay Webhook Configuration

• Open your Razorpay Dashboard → Webhooks.
• Click Add New Webhook and configure the endpoint:

  http

  Copy

  https://payapi.zezo.in/api/v1/payments/verify/razorpay

• Set your Webhook Secret and select events:
  • payment.authorized
  • payment.captured
  • payment.failed
  • refund.created
• Copy the Webhook Secret into ZezoPay Dashboard → Settings → Payments → Razorpay Webhook Secret.

2. Stripe Webhook Configuration

• Open Stripe Dashboard → Developers → Webhooks.
• Click Add endpoint and enter the URL:

  http

  Copy

  https://payapi.zezo.in/api/v1/payments/verify/stripe

• Subscribe to:
  • payment_intent.succeeded
  • payment_intent.payment_failed
  • charge.refunded
  • checkout.session.completed
• Copy the Signing Secret (whsec_...) into ZezoPay Dashboard → Settings → Payments → Stripe Webhook Secret.