Merchant Integration Guide
Accept gift card payments on your platform with our easy-to-integrate API. Get set up in minutes and start accepting payments today.
Why Integrate MaziCard?
Our payment gateway is designed for developers, with enterprise-grade security and reliability that businesses trust.
Real-time Processing
Sub-second transaction processing with instant confirmation
Secure by Design
PCI-DSS compliant with end-to-end encryption
Analytics Dashboard
Track transactions, settlements, and customer insights
Webhook Support
Real-time notifications for transaction events
Developer Friendly
Clean REST API with comprehensive documentation
Easy Configuration
Customize settings, branding, and payment flows
Getting Started
Sign Up as a Merchant
Create your merchant account and complete the verification process.
- Provide business details (name, type, registration)
- Upload KYC documents (PAN, GST, bank details)
- Wait for verification (typically 24-48 hours)
- Receive approval email with dashboard access
Get Your API Keys
Generate secure API credentials for integration.
- Access your merchant dashboard
- Navigate to API Keys section
- Generate test keys for sandbox environment
- Generate live keys after testing complete
Integrate the API
Add gift card payment acceptance to your checkout.
- Use our REST API or SDK
- Implement HMAC authentication
- Set up webhook endpoints
- Test in sandbox environment
Go Live
Launch gift card payments for your customers.
- Switch to production API keys
- Final security review
- Monitor dashboard for transactions
- Access settlement reports
API Overview
Our RESTful API uses standard HTTP methods and returns JSON responses. All requests must be authenticated using HMAC signatures.
Key Endpoints
/api/v1/payments/initiateCreate a new payment request/api/v1/payments/{id}/verifyVerify payment status/api/v1/payments/{id}/redeemRedeem gift card balance/api/v1/payments/{id}/refundProcess a refund/api/v1/giftcards/{code}/balanceCheck gift card balance// Initialize payment
const response = await fetch('https://api.mazicard.com/api/v1/payments/initiate', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'your_api_key',
'X-Timestamp': Date.now().toString(),
'X-Signature': hmacSignature,
},
body: JSON.stringify({
amount: 1500,
currency: 'INR',
orderId: 'ORDER_123',
description: 'Purchase at Your Store',
customerEmail: 'customer@example.com',
redirectUrl: 'https://yourstore.com/payment/callback',
}),
});
const { paymentId, paymentUrl } = await response.json();
// Redirect customer to paymentUrlHMAC Authentication
All API requests must include HMAC-SHA256 signatures for security. The signature is computed using your API secret and the request body.
Required Headers:
X-API-Key: your_api_key
X-Timestamp: unix_timestamp
X-Signature: hmac_sha256(secret, timestamp + body)Developer Resources
Ready to Accept Gift Card Payments?
Join hundreds of merchants already using MaziCard to grow their business. Get started in minutes with our developer-friendly API.