D-Store offers a cost-efficient integration solution to Point-Of-Sale (POS) providers who cooperate with food and beverage (F&B) merchants to take dine-in and pick-up orders in the merchants' digital stores. With this solution, POS providers can implement the following capabilities:

• Synchronize product information with D-Store
• Receive order creation requests and order information from D-Store
• Update order changes with D-Store

To integrate this solution, the POS provider needs to complete the following steps:

• Step 1: Prepare for integration
• Step 2: Integrate D-Store APIs
• Step 3: Conduct sandbox acceptance testing
• Step 4: Onboard your merchants and go live

How it works

The following figure illustrates how the integration solution works.

Figure 1. Integration workflow

The workflow consists of the following steps:

1. The POS server synchronizes the product information with D-Store.
2. The D-Store server synchronizes product information with its multiple client terminals, such as mini-program, native app, mobile web page, and desktop web page. The client terminal then necessarily displays the product information to the user.
3. After the user places an order and completes the payment, the D-Store client terminal sends a request to the POS server to create an order.
4. The POS server receives the order creation request and order information, such as the payment amount, order items, and order amount details, from D-Store. The POS server then places orders to the merchant POS.
5. Once there is any order change, the merchant POS passes the order change to the POS server. The POS server then updates the order information with D-Store.

Before you begin

Before you start the integration, it is recommended to learn about the following things:

• D-Store APIs send HTTPS requests and receive responses using the POST method. For more information about the structure of a request and response, see API overview.
• When calling D-Store APIs, to ensure message transmission security, the POS provider must perform message signing and signature validation properly. For more information, see Call an API via adding a signature.

Step 1: Prepare for integration

To get prepared for the integration, perform the following actions:

1. Sign the NDA

Contact the D-Store Business Development (BD) team to obtain and sign the Non-Disclosure Agreement (NDA), which will enable you to access additional support and resources from D-Store.

2. Exchange sandbox resources

To prepare for the API development and testing, you need to exchange sandbox resources with D-Store. The following table lists the sandbox resources and the corresponding tasks.

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgnqkU20qdSx6fZ0OdKmudiP5uUHAEUnuZM+qTno0viWA6o5nWtn0r6K7F3k5zNhjZTZOjhJwMS7rhlu9gxCr25YOd4KJDJherKvwm3T3EWZbN22OG6i07SqqrGVq1M+3GdQ2tZL6mOmEISL+UTxefQbcUqRIFIZMC80qBqhRsMtxEdF/uiNIeOccPm5k/GwGVwflsNU7lp5IVuDMgl1mmcq9i0nNszwZ8uU7ABXV29FtWMB+82/rOZ1hYkBdJcpfrA/ut2AsOHAVevKzg1DlT91A1yNqXyixXhOVHC2nEP7KZZ13ol2egEHEFbTmpHNMhdynEUZ73kIR4sCTpmaOxQIDAQAB

$ openssl
OpenSSL> genrsa -out rsa_private_key.pem 2048
OpenSSL> pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt
OpenSSL> rsa -in rsa_private_key.pem -pubout -out  rsa_public_key.pem
OpenSSL> exit

Note: Sandbox resources cannot take effect in the production environment. To launch your codes and go live, you need to replace the sandbox resources with production resources to configure the production environment. For more information, see Configure the production environment.

Step 2: Integrate D-Store APIs

To implement D-Store F&B capabilities, you need to integrate a series of APIs provided by D-Store.

API list

The following table lists the APIs in terms of endpoint and calling direction. You can click the API name to see the detailed specification of each API.

Sequence flow

The following figures illustrate the sequence flow of calling D-Store APIs in dine-in and pick-up scenarios.

Figure 2. API sequence flow

The sequence flow consists of the following steps:

1. The POS provider calls the syncProduct API to pass the product information to D-Store.
2. After the user places an order and pays, D-Store calls the createOrder API to request the POS provider to create an order for the user.
3. After the order is created, the POS provider calls the notifyOrderChange API to inform D-Store about any order updates, such as changes in order amount, order status, and so on. Moreover, D-Store can call the inquireOrderDetail API to actively track order changes.

Step 3: Conduct sandbox acceptance testing

After you integrate D-Store APIs and perform free tests in the sandbox, contact the SA for the sandbox acceptance testing. The SA provides a series of test cases that are designed by D-Store. Complete the required test cases and report the results to the SA.

Step 4: Onboard your merchants and go live

When all the test cases are passed and verified by the SA, you can go live by taking the following steps:

Configure the production environment

To prepare for going live, you need to configure the production environment with production resources. Refer to the following table and complete the tasks.

$ openssl
OpenSSL> genrsa -out rsa_private_key.pem 2048
OpenSSL> pkcs8 -topk8 -inform PEM -in rsa_private_key.pem -outform PEM -nocrypt
OpenSSL> rsa -in rsa_private_key.pem -pubout -out  rsa_public_key.pem
OpenSSL> exit

Go live

Once you configure the production environment as required, you are ready to launch your codes, onboard your merchants, and start your business. If you need any support in troubleshooting or merchant onboarding, contact the SA.