Payment extension
A payment extension is a payment application integrated with the Genstore Merchant Admin. Payment partners who meet Genstore's requirements and pass the approval process can create and publish payment extensions via the Genstore Developer Center, offering merchants customized payment processing capabilities.
Approved payment extension applications will appear in the Genstore Merchant Admin under Settings → Payments in the payment gateway list. Merchants can install the extension here, and after completing the authorization and configuration, they can activate and use it.
Core value
Payment extensions allow partners to provide a variety of payment methods to merchants, catering to different regional and customer needs, including:
- Credit card payments
- Wallet payments
- Other payment methods such as buy now, pay later, installment payments, buyer financing, etc.
- Bank transfers
- Convenience store payments
- Cryptocurrencies
Payment extension models
Developers can choose the appropriate model based on business requirements, and merchants can activate multiple extensions simultaneously to offer a broader range of payment methods to customers:
- Card payment: Accepts credit card payments directly on the checkout page and supports 3D Secure verification.
- Redirect model: The buyer is redirected to the payment provider's hosted page to complete the payment and then returns to the store.
Workflow
The basic workflow of a payment extension application is as follows:
- The merchant logs in to the Genstore Merchant Admin, navigates to Settings → Payments → More payment methods, and installs the extension from the payment gateway list.
- The system will pop up the standard application authorization page.
- After the merchant confirms the action, they are redirected to the payment application page for authorization configuration.
- Before the authorization is complete, a banner will notify the merchant that the payment application is not yet ready.
- The merchant performs the authorization action, and the payment application uses the Genstore API to notify Genstore that the authorization has been completed.
- The merchant can activate the payment extension application.
The following diagram illustrates the basic development process of the payment extension application and the interaction between the merchant and the payment extension application:
Supported actions
The payment extension should support the following actions. For a detailed process, please refer to payment processing flow:
- Initiate payment: The payment application partner collects the buyer’s payment information and charges the payment fee.
- Refund: Initiate a refund request for a completed payment.
- Capture: Capture funds for an authorized payment, completing the transaction and charging the user’s account.
- Void: Void a payment before the funds are captured, preventing the actual deduction.
- Query payment results: Query the current status and details of a specific payment transaction, including authorization, capture, or failure status.
- Query refund status: Query the status and related information of a refund request, supporting retrieval by refund number.