EC Integration: Coupang
Table of Contents
- Section 1: Use Cases — 2 Application Examples
- Section 2: Feature Guide — Connection / Credentials / Return & Outbound Centers / Settings
- Section 3: FAQ — 8 FAQs + Notes
- Section 4: Related Features
Section 1: Use Cases
Quick Links: Connect a Coupang Store | Update Return/Outbound Centers
Scenario 1: Connect the Coupang Platform
Situation: A merchant opened a store on Coupang and wants orders imported into the warehouse system automatically.
How to Do It:
▸ Apply for Credentials and IP Whitelisting
- Apply for API access with Coupang to obtain the Vendor ID, Access Key, and Secret Key
- Provide the server IP shown on the settings page to Coupang for whitelisting
▸ Create the Account and Test the Connection
- Click "New" on the "EC Integrations" page
- Select the merchant this account belongs to
- Choose "Coupang" as the "E-commerce Platform", fill in the "Display Name", and select the "Channel Name"
- Enter the credentials provided by Coupang
- Click "Test Connection" and confirm "Connection Successful" appears
▸ Set Return/Outbound Centers and Complete the Settings
- In the "Return / Outbound Center Settings" section of the "Settings" panel, select the return centers and outbound place
- Enable "Fetch Orders" and select the "Fetch Schedule"
- Click "Save"
Result: The system fetches Coupang orders automatically at the scheduled times; check them in the Orders list.
Scenario 2: Reselect a Return Center or Outbound Place
Situation: After the warehouse relocated, the merchant updated the return centers and outbound places in the Coupang backend, and the system needs the refreshed options.
How to Do It:
- Find the account in the "EC Integrations" list and open it for editing
- In "Return / Outbound Center Settings", click "Load Locations from Coupang"
- Reselect the return centers and outbound place from the refreshed list
- Click "Save"
Result: Subsequent orders use the new return center and outbound place information.
Section 2: Feature Guide
Coupang is a major Korean e-commerce platform actively expanding into Taiwan. Once integrated, the system fetches new orders from Coupang on schedule and automatically sends tracking numbers back to Coupang after shipment. Coupang integrates via credentials, requires IP whitelisting by Coupang before connecting, and needs return centers and outbound places configured for the shipping methods in use.
Quick Links: Connection Info | Credentials | Return & Outbound Centers | Settings
2.1 Connection Info
| Field | Description | Required |
|---|---|---|
| Merchant | The merchant this account belongs to (selected first when creating) | ✓ |
| E-commerce Platform | Select "Coupang"; cannot be changed after creation | ✓ |
| Display Name | Custom account name for identification (e.g., Coupang Official Store) | ✓ |
| Channel Name | Select the corresponding sales channel; if missing, create it under Sales Channels first | ✓ |
2.2 Credentials
Prerequisite: IP Whitelisting
⚠️ Important: The Coupang API requires IP whitelisting before it can connect. The settings page shows the server IP that needs whitelisting — contact Coupang to add it before configuring.
How to Get Coupang API Credentials
- Log in to the Coupang seller backend (Wing)
- Go to "Settings" → "API Management" or contact Coupang support
- Obtain the following credentials:
- Vendor ID
- Access Key
- Secret Key
| Field | Description | Required |
|---|---|---|
| Vendor ID | Vendor identifier provided by Coupang | ✓ |
| Access Key | Access Key provided by Coupang | ✓ |
| Secret Key | Secret Key provided by Coupang | ✓ |
Test Connection: After entering all credentials, click "Test Connection". The settings panel on the right unlocks only after "Connection Successful" appears.
2.3 Return / Outbound Center Settings
After a successful connection, the system automatically loads the selectable return centers and outbound places from Coupang. To refresh the list, click "Load Locations from Coupang".
| Field | Description | Usage |
|---|---|---|
| Return Center Code (7-11) | Return center for 7-11 pickup | Required for 7-11 pickup |
| Return Center Code (FamilyMart) | Return center for FamilyMart pickup | Required for FamilyMart pickup |
| Outbound Place Code (Home Delivery - Kerry TJ / HCT) | Outbound place for home delivery, shared between Kerry TJ and HCT | Required for home delivery |
2.4 Settings
Order Fetching
| Field | Description |
|---|---|
| Fetch Orders | When enabled, the system fetches orders automatically |
| Fetch Schedule | Up to 3 time slots; at least 1 is required when order fetching is enabled |
Section 3: FAQ
3.1 FAQ
▪ What is the IP whitelist and why is it needed?
The Coupang API is protected by an IP whitelist — only authorized IP addresses can access it. You need to:
- Note the server IP shown on the system settings page
- Contact Coupang support or apply in the backend to whitelist that IP
- Wait for Coupang's approval before the connection works
▪ What if the connection test fails?
Check in order:
- Has the IP whitelisting been completed (most common cause)?
- Is the Vendor ID correct?
- Are the Access Key and Secret Key correct?
▪ Why are orders not being fetched automatically?
Check in order:
- Is "Fetch Orders" enabled?
- Is a "Fetch Schedule" set?
- Is the connection status "Connected" and the IP whitelist still valid?
▪ What if the return/outbound center list is empty?
- Confirm the credentials are correct and the IP has been whitelisted
- Confirm the return centers and outbound places are configured in the Coupang backend
- Click "Load Locations from Coupang" to reload
▪ Do 7-11 and FamilyMart return centers need separate setup?
Yes. In Coupang's convenience-store pickup system, 7-11 and FamilyMart are separate logistics channels, each needing its own return center. If only one chain is used, only that chain's return center is required.
▪ Can I set up multiple Coupang stores?
Yes. If a merchant has multiple Coupang stores, create a separate account for each with its own credentials.
▪ Do the credentials expire?
Coupang API credentials generally do not expire automatically. However, if keys are regenerated in the Coupang backend, the old keys become invalid — update the settings in this system and test the connection again.
▪ Does Coupang need shipping type mappings?
No. Coupang manages shipping methods centrally and the system handles Coupang logistics information automatically; you only need to complete the return center and outbound place settings.
3.2 Notes
⚠️ Important Reminders
- IP whitelisting is required: This is the most commonly missed step — be sure to confirm it
- Credential security: Keep the Access Key and Secret Key safe; do not share them
- Return/outbound centers must be set: Configure the addresses for the shipping methods in use
- Test before enabling: Test the connection successfully before enabling order fetching
Section 4: Related Features
| Feature | Description | Link |
|---|---|---|
| Order List | View orders fetched from Coupang | Go |
| Shipping Types | Configure warehouse shipping methods | Go |
| Sales Channels | Manage merchant sales channel settings | Go |