Merchant Settings

Objective

Maintain merchant basic information (contact person, contact phone) and manage API access credentials (App ID / App Secret) to ensure the warehouse can contact you in time and external systems can normally connect to the OSL Open API.

Entry: Left Navigation → System Settings → Merchant Settings

Page Overview

The merchant settings page contains two tabs:

• Merchant Information: Maintain basic information such as contact person and contact phone.
• API Information: View and copy API access credentials.

The top of the page displays fields that are automatically generated during registration and cannot be modified, followed by the operational area below.

Field Description:

• Merchant ID: A unique identifier automatically generated during registration. The warehouse and technical support can use this to quickly locate your account.
• Merchant Name: Filled in during registration. If you need to change it, please contact the business manager.
• Status: Activated / Not Activated. Account functions are limited in the unactivated state, and activation must be completed first.
• Email: The notification email filled in during registration. The system will send bills, exception reminders, and other notifications to this email.
• Merchant Address: The merchant address filled in during registration.
• Dedicated Service Support: Service consultant name and contact phone (if assigned), which can be contacted directly.

Common Business Scenarios

Scenario 1: The warehouse needs to contact me, but my phone number has changed

The warehouse will communicate with you through contact information in cases of receiving exceptions, replenishment needs, etc. Please be sure to keep it up to date.

1. Open merchant settings and switch to the 「Merchant Information」 tab.
2. Fill in the new contact person name in the "Contact Person" input box (up to 50 characters).
3. Fill in the new contact phone in the "Contact Phone" input box (up to 20 characters).
4. Click the 「Save」 button to submit the changes.
5. After modification, the warehouse side will see the latest information synchronously.

Field Description:

• Contact Person: The person the warehouse contacts in exceptional situations. It is recommended to fill in the daily operations manager.
• Contact Phone: It is recommended to fill in the mobile phone number for easy contact by the warehouse.

Scenario 2: Connecting to ERP or automated systems requires API credentials

If you use an ERP system, order management tool, or self-built system to connect to the OSL Open API, you need App ID and App Secret for identity verification.

1. Open merchant settings and switch to the 「API Information」 tab.
2. On the right side of App ID, click the 「Copy」 icon, and the credential ID has been copied to the clipboard.
3. On the right side of App Secret, click the 「Copy」 icon, and the credential key has been copied to the clipboard.
4. Paste the App ID and App Secret into the configuration items of the external system.
5. Before API access, please confirm the interface permissions and documentation with the OSL business manager.

Field Description:

• App ID: Merchant API access credential ID, used to identify your merchant identity.
• App Secret: Merchant API access credential key, used in pairs with App ID, equivalent to a password.
• The two must be used together. Identity verification cannot be completed with only the App ID.

Scenario 3: Suspected API key leakage

App Secret is sensitive information. Once leaked, it may be used by others to impersonate and call the API.

1. Immediately stop all external system calls using this App Secret.
2. Contact the OSL business manager to apply for resetting the App Secret.
3. After the business manager resets it, the new App Secret will be displayed in the "API Information" tab.
4. Synchronously update the new App Secret to all external system configurations.
5. Restart API calls and observe the call logs to confirm normality.

Note:

• After the App Secret is reset, the original App Secret becomes invalid immediately, and all calls using the old key will fail.
• Please operate during off-peak business hours to avoid affecting normal business.
• After resetting, please keep the new key properly to avoid leakage again.

Scenario 4: View my dedicated service consultant

1. Open merchant settings and switch to the 「Merchant Information」 tab.
2. View the service consultant name and contact phone in the "Dedicated Service Support" field.
3. If this field is empty, it means that no dedicated service consultant has been assigned. Please contact the OSL business manager to apply.

Field Description:

• Dedicated Service Support: The service consultant assigned to you by OSL can be contacted first during business consultations and problem handling.

Scenario 5: How to activate an unactivated account

1. Open merchant settings and view the "Status" field at the top.
2. If it shows "Not Activated", it means the account functions are limited and activation must be completed first.
3. For the activation process, see Getting Started - Account Registration and Activation.
4. After activation is complete, the status changes to "Activated", and all functions can be used normally.

Frequently Asked Questions

Can the merchant name or merchant address be changed

• The merchant name and merchant address are filled in during registration and cannot be modified by yourself after registration.
• If you need to modify them, please contact the OSL business manager for assistance.

Can the email be changed

• The email is filled in during registration and cannot be modified by yourself at present.
• The email is used to receive bills, exception reminders, and other notifications. Please ensure the email is valid.
• If you need to modify the email, please contact the OSL business manager.

What should I do if I forget the App ID and App Secret

• Open Merchant Settings → API Information tab, where you can view and copy them at any time.
• The App ID will not change. If the App Secret is leaked, you need to contact the business manager to reset it.

What should I do if the API call returns 401 Unauthorized

• Please confirm that the App ID and App Secret are configured correctly, without extra spaces or characters.
• Please confirm that the App Secret has not been reset. If it has been reset, please use the new key.
• Please confirm that the interface permissions have been opened, which needs to be confirmed with the OSL business manager.
• If it still cannot be resolved, please contact the OSL business manager for technical support.

How long will it take for the warehouse to see the modified contact information

• It takes effect immediately after modification and saving, and the warehouse side synchronizes the latest information in real time.
• No additional operations are required, and the warehouse can view the latest contact information in the system.