The Alipay Mini Program is a game-changer for businesses. It allows you to create a custom app-like experience for your customers, right within the Alipay app.
With over 1 billion active users, Alipay is one of the most widely used payment platforms in China. This means your business can reach a massive audience with a single integration.
You can create a Mini Program in just a few hours, thanks to Alipay's user-friendly development tools. No need to worry about complex coding or lengthy development cycles.
Integration
Integration is crucial to a successful Alipay Mini Program experience. You'll need to integrate the pay API to enable secure and seamless payments.
To integrate the pay API, you'll need to specify the request parameters correctly. For example, you should specify MINI_APP as the terminal type in the order.env.terminalType parameter.
Here's a summary of the request parameter differences between the merchant platform and mini program:
After integrating the pay API, Alipay+ will return the MPP's cashier page URL in the normalUrl parameter. You'll need to pass this parameter to your merchant side for subsequent steps.
Why Using
I've been working with web apps for a while, and I've noticed that HTML5 apps have some major limitations. They're sandboxed, which means they can't access native device capabilities like reliable network connections or powerful storage.
This can lead to frustrating issues like waiting for resources to download, which can cause white-screen problems. And let's be honest, who likes waiting around for their app to load?
One of the biggest benefits of using Mini Programs is that you can acquire app services without installing a full app. This is a huge time-saver, and it's especially useful for users with limited storage space.
Here are some key benefits of using Mini Programs:
- Acquiring App services without installing Apps
- Faster loading
- More powerful capacities
- Almost native experience
- Efficient and simple development
I've seen firsthand how Mini Programs can provide a smoother user experience. They're faster, more powerful, and almost indistinguishable from native apps.
Steps for Integration
To integrate Mini Programs, you'll need to follow these steps.
First, integrate the pay API, paying attention to the differences in request parameters for Mini Program scenarios.
Specify the request parameter order.env.terminalType as MINI_APP, and paymentMethod.paymentMethodType as the wallet that hosts the mini program, which has valid values.
After processing your request, Alipay+ returns the MPP's cashier page URL in the normalUrl parameter, which you need to pass to your merchant side for subsequent steps.
To implement Cashier Payment capability, instruct your merchants to follow the procedure outlined in the Cashier Payment guide, focusing on the differences when accepting payments with Mini Programs compared to other merchant platforms.
For a smoother user experience, consider the benefits of using Mini Programs, such as acquiring App services without installing Apps, faster loading, more powerful capacities, almost native experience, and efficient and simple development.
Here's a summary of the operating environments of Mini Program:
By understanding these operating environments, you can better navigate the development process and ensure a seamless user experience.
To get started with Mini Program development, check the Developer's Guide for components and APIs, and consider the benefits of using Mini Programs, such as faster loading and more powerful capacities.
Order Management
Order Management is a crucial aspect of the Alipay Mini Program, allowing businesses to efficiently manage orders from various channels. This includes managing orders from the Mini Program, Alipay's official website, and other sales channels.
With the Alipay Mini Program, businesses can automatically synchronize orders across all sales channels, ensuring that inventory is up-to-date and reducing the risk of overselling.
Get Merchants Onboarded
To get your merchants onboarded, you'll need to instruct them to get onboarded to the Mini Program Platform. This is the first step in the process.
For more information about the onboarding process, you can refer to the merchant onboarding section. It's essential to ensure that your merchants complete this step before proceeding.
Here's a step-by-step guide to get your merchants onboarded:
1. Instruct your merchants to get onboarded to Alipay+ Mini Program Platform.
2. Instruct your merchants to build their mini programs on the platform.
You can find more details about the onboarding process in the merchant onboarding section.
Order Apply Request
The Order Apply Request is a crucial step in the order management process. To initiate this request, you'll need to provide several parameters, which we'll break down below.
The appid parameter is required and should be a string of 32 characters, representing your merchant number in the format mch{Merchant No}.
The nonce_str parameter is also required, and it's a random string of 32 characters.
You'll need to specify the channel parameter, which can be either "wechat" or "alipay".
The sign parameter is a digital signature used to verify the authenticity of digital messages, and it's required.
In addition to these parameters, you'll need to provide the mch_order_no, local_total_fee, and fee_type parameters, all of which are required.
Here's a summary of the required parameters in a table:
These parameters are crucial in initiating the Order Apply Request, and failing to provide them may result in errors or delays in the order management process.
Order Closed Successfully
When an order is closed successfully, you'll receive a response with a code of 0, indicating a successful operation.
The response will also include a digital signature, known as the sign, which is a string of 256 characters that verifies the authenticity of the digital message. This signature can be checked using the Signature Algorithm page.
The response will also contain a message, or msg, which is a string of 32 characters that provides a brief description of the response.
Here are the key parameters you can expect to see in a successful order close response:
The result parameter will be set to SUCCESS, indicating that the order was closed successfully.
Refund Query Success
You've successfully queried a refund, and now you're wondering what happens next. The refund query request parameters are similar to the order refund request parameters, but with some key differences.
The refund query request must include the sign parameter, which is a digital signature for verifying the authenticity of digital messages. This signature is generated using a specific algorithm, which is explained in the Signature Algorithm page.
To query a refund, you'll need to provide at least one of the order number parameters: mch_order_no, ksher_order_no, or channel_order_no. Each of these parameters represents a unique order number.
Here are the possible order number parameters and their descriptions:
In addition to the order number parameters, you'll also need to provide the total_fee parameter, which represents the total amount of the order in cents. The fee_type parameter is also required, which specifies the currency code for the total_fee. The possible values for fee_type are: THB, MYR, JPY, and AED.
The refund query request also includes the mch_refund_no parameter, which is a unique refund number generated by the merchant. The refund_fee parameter represents the amount to refund, also in cents. Refund partly is permitted, so you can refund a portion of the total amount if needed.
Finally, the refund query request can include optional parameters such as attach, device_id, and operator_id. These parameters allow you to add extra information, specify the terminal ID, and identify the operator ID, respectively.
Sources
- http://api.ksher.net/KsherAPI/dev/apis/alipay_minipro.html
- https://digitalcreative.cn/blog/china-mini-programs-ecosystems-wechat-alipay-douyin
- https://docs.alipayplus.com/alipayplus/alipayplus/integration_cashier_acq/cashier_with_mini_program
- https://miniprogram.alipay.com/docs/about/
- https://en.finclip.com/products/finclip-minis
Featured Images: pexels.com