October 6, 2025 - v1.0.0
Overview
This release marks the official launch of the DVPay Payment Gateway API v1.0.0. All core payment processing features are now production-ready.
New Features
1. API Key Authentication System
What's New
Introduced secure API key authentication using three required headers:
X-App-Id: Application identifierX-Api-Key: Secret API keyX-Timestamp: Unix timestamp for request validation
Impact of Feature
- Provides secure, stateless authentication
- No session management required
- Simple integration for developers
- Timestamp validation prevents replay attacks
Implementation Reference
→ Authentication Documentation
2. Create Payment Order Endpoint
What's New
New endpoint to create payment orders with automatic QR code generation:
POST /api/v1/payment-gateway/order/create
Supported Features:
- Multi-currency support (USD, KHR)
- Automatic QR code generation
- Real-time order status tracking
- Store-level organization
Impact of Feature
- Enables merchants to accept payments instantly
- QR codes generated automatically for each order
- Supports multiple currencies for international transactions
- Provides order tracking from creation to completion
Implementation Reference
→ Create Order API Documentation
3. QR Code Generation Endpoint
What's New
Standalone QR code generation without full order creation flow:
POST /api/v1/payment-gateway/qr/generate
Impact of Feature
- Enables quick payment QR generation for POS systems
- Reduces API calls for simple payment scenarios
- Supports dynamic amount adjustment
- Lower latency for high-volume merchants
Implementation Reference
→ Generate QR API Documentation
4. Transaction Detail Query
What's New
Retrieve comprehensive transaction information:
GET /api/v1/payment-gateway/transaction/detail
Returned Information:
- Transaction status (pending, completed, failed)
- Payment amounts and currency
- Timestamps (created, updated, completed)
- QR code details
- Customer information (if available)
Impact of Feature
- Enables real-time payment status verification
- Supports reconciliation workflows
- Provides audit trail for compliance
- Facilitates customer support operations
Implementation Reference
→ Transaction Detail API Documentation
5. Refund Processing
What's New
Process full or partial refunds for completed orders:
POST /api/v1/payment-gateway/order/refund
Capabilities:
- Full refund support
- Partial refund with amount specification
- Refund status tracking
- Automatic validation against original order amount
Impact of Feature
- Enables customer service refund workflows
- Supports partial refunds for flexible customer service
- Automatic validation prevents over-refunding
- Complete refund audit trail
Implementation Reference
→ Refund Order API Documentation
6. Order Cancellation
What's New
Cancel pending orders before payment completion:
POST /api/v1/payment-gateway/order/cancel
Features:
- Only pending orders can be cancelled
- Immediate order status update
- Prevents payment processing after cancellation
- Automatic QR code invalidation
Impact of Feature
- Enables order management flexibility
- Prevents unwanted payments
- Supports inventory management systems
- Clean cancellation workflow
Implementation Reference
→ Cancel Order API Documentation
7. Payout Processing
What's New
Transfer funds to specified accounts:
POST /api/v1/payment-gateway/payout
Capabilities:
- Support for multiple payout methods
- Automatic balance validation
- Real-time payout status tracking
- Configurable payout schedules
Impact of Feature
- Enables automated seller payments
- Supports marketplace and platform businesses
- Real-time settlement capabilities
- Complete payout audit trail
Implementation Reference
Technical Details
API Base URL
https://merchant.dv.vai247.pro/api/v1
Supported Content Types
application/json(required for all requests)
Rate Limits
- 1000 requests per minute per API key
- 10,000 requests per hour per API key
Response Format
All responses follow standard JSON format with consistent error handling.
Migration Notes
This is the initial release. No migration required.
Known Limitations
- Webhook notifications not yet supported (planned for next release)
- Batch operations are not available
- The maximum refund amount is limited to the original order amount
- QR codes expire after 24 hours
Documentation
Full API documentation available at: