ShoAPI - Laravel Shopee API SDK (V2)

This is a Unofficial Shopee PHP Client for Laravel 9|10 and currently supported API V2

ShoAPi lets you develop Shopee Open API in Laravel. ShoAPi is an HTTP-based interface created for developers interested Shopee Open API. To learn more about the Shopee Open API, please consult the Introduction on the official Shopee Open Platform site.

Installation

Via Composer

$ composer require muhanz/shoapi

Before Start

Configure your variables in your .env (recommended) or you can publish the config file and change it there.

SHOPEE_PRODUCTION=false // Default
SHOPEE_HOST_URL='https://partner.shopeemobile.com'
SHOPEE_SANDBOX_HOST_URL='https://partner.test-stable.shopeemobile.com'
SHOPEE_CALLBACK_URL='/shopee/auth/get_access_token' // Example: for redirect after auth
SHOPEE_PARTNER_ID=<YOUR_PARTNER_ID>
SHOPEE_PARTNER_KEY=<YOUR_PARTNER_KEY>

(Optional) You can publish the config file via this command:

php artisan vendor:publish --provider="Muhanz\Shoapi\ShoapiServiceProvider" --tag="shoapi.config"

Authorization and Authentication

// Add this facades on top controller
use Muhanz\Shoapi\Facades\Shoapi;

public function auth_partner()
{
    return Shoapi::call('shop')->access('auth_partner')->redirect(); // auto redirect
    
    // or
    
    return Shoapi::call('shop')->access('auth_partner')->getUrl();
    
    // response:
    // https://partner.test-stable.shopeemobile.com/api/v2/shop/auth_partner?partner_id=partner_idtimestamp=1697215282&sign=sign_code&redirect=redirect_url   
}

For cancel/disconnet auth partner

return Shoapi::call('shop')->access('cancel_auth_partner')->redirect();

Get Access Token & Refresh Access Token

The access_token is a dynamic token, and you need to pass access_token to call non-public APIs. Each access_token is valid for 4 hours and can be used multiple times within 4 hours. However, you need to refresh the access token by calling RefreshAccessToken before it expires in order to obtain a new access_token.

Refresh_token is a parameter used to refresh access_token. Each refresh_token is valid for 30 days.

⚠️ Note: The access_token and refresh_token of each shop_id and merchant_id need to be saved separately.

Get Access Token:

// After authorization, the front-end page will redirect to the redirect URL in your authorization link:
// https://open.shopee.com/?code=xxxxxxxxxx&shop_id=xxxxxx

$params =  [
	'code'  =>  "54494572544875766********", 
	'shop_id'  =>  (int)  000000,
];

$response = Shoapi::call('auth')
		->access('get_access_token')
		->shop(000000)
		->request($params)
		->response();
				
dd($response);

Get Refresh Access Token:

$params =  [
	'refresh_token'  =>  "527a424f54494572544875766*******",
	'shop_id'  =>  (int)  000000,
];

$response =  Shoapi::call('auth')
		->access('refresh_access_token')
		->shop(000000)
		->request($params)
		->response();

dd($response);

Example Response:

{
	api_status:"success",
	partner_id:000000,
	refresh_token:"527a424f54494572544875766*******",
	access_token:"786b4c74526e52426555616e*******",
	expire_in:14400,
	request_id:"84ec4d8971735d62dca40c0*******",
	shop_id:000000
}

Basic Usage

// Add this facades on top controller
use Muhanz\Shoapi\Facades\Shoapi;

public function get_shop_info()
{
	
	// path api: /api/v2/shop(use in call)/get_shop_info(use in access)

  return Shoapi::call('shop')
		->access('get_shop_info', <YOUR_ACCESS_TOKEN>)
		->shop(<YOUR_SHOP_ID>)
		->response();
}

Other Example:

// Add this facades on top controller
use Muhanz\Shoapi\Facades\Shoapi;

public  function  get_category()
{

	$params =  [
		'language'  =>  'id'  // en
	];

	$response = Shoapi::call('product')
			->access('get_category',  <YOUR_ACCESS_TOKEN>)
			->shop(<YOUR_SHOP_ID>)
			->request($params)
			->response();
	dd($response);
}

Example Response:

{
	api_status:"success",
	category_list:[
		{
			category_id:100001,
			parent_category_id:0,
			original_category_name:"Health",
			display_category_name:"Kesehatan",
			has_children:true

		}
	]
}

Support Methods

Currently supported all methods exclude GlobalProduct(CB seller only) please open Shopee Open Platform

Service (call)	Method (access)
Product	add_item, get_category and 35 others	✅
Global Product(CB seller only)	- Not Tested	❌
MediaSpace	upload_image, upload_video, etc	✅
Shop	get_info_shop, get_profile, update_profile, etc	✅
Merchant	get_merchant_info, get_shop_list_by_merchant, etc	✅
Order	get_order_list, get_order_detail and 11 others	✅
Logistics	get_shipping_parameter, get_tracking_number, and 14 others	✅
First Miles	get_unbind_order_list, get_detail, etc	✅
Payment	get_escrow_detail, set_shop_installment_status, etc	✅
Discount	add_discount, add_discount_item, etc	✅
Bundle Deal	add_bundle_deal, add_bundle_deal_item, etc	✅
Add-On Deal	add_add_on_deal, add_add_on_deal_main_item, etc	✅
Voucher	add_voucher, delete_voucher, etc	✅
Follow Prize	add_follow_prize, delete_follow_prize, etc	✅
Top Picks	get_top_picks_list, add_top_picks, etc	✅
Shop Category	add_shop_category, get_shop_category_list, etc	✅
Returns	get_return_detail, get_return_list, etc	✅
Account Health	shop_performance, shop_penalty	✅
Public	get_shops_by_partner, get_access_token,refresh_access_token, etc	✅
Push	set_app_push_config, get_app_push_config	✅

Documentation

Please refer to the official documentation Shopee Open Platform

Change log

Please see the changelog for more information on what has changed recently.

Contributing

Please see contributing.md for details and a todolist.

Credits

• Mu Hanz
• All Contributors

License

MIT. Please see the license file for more information.