PHPackages nizerin/alipay-global - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. nizerin/alipay-global ActiveLibrary[Payment Processing](/categories/payments) nizerin/alipay-global ===================== Alipay Global Third Party SDK, 支付宝 国际版 SDK for PHP 1.0.0(4y ago)332MITPHPPHP >=5.6.0 Since Mar 31Pushed 4y ago1 watchersCompare [ Source](https://github.com/NiZerin/alipay-global)[ Packagist](https://packagist.org/packages/nizerin/alipay-global)[ RSS](/packages/nizerin-alipay-global/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)DependenciesVersions (2)Used By (0) Alipay Global SDK PHP ===================== [](#alipay-global-sdk-php) Alipay Global A+ SDK -------------------- [](#alipay-global-a-sdk) This project is based on [Alipay Global Offical PHP SDK](https://github.com/alipay/global-open-sdk-php) Since official SDK mainly shows how to access the alipay gateway and does not contain complete functions such as authorization and auto debit, I have added some logic and further realized the standard interface of Alipay Global A+ Use --- [](#use) ``` composer require NiZerin/alipay-global ``` How to use ---------- [](#how-to-use) ### Initialize [](#initialize) ``` $alipayGlobal = new NiZerin\AliPayGlobal(array( 'client_id' => 'SANDBOX_5Y3A2N2YEB3002022', // Client ID 'endpoint_area' => 'ASIA', // Optional: NORTH_AMERIA / ASIA / EUROPE 'merchantPrivateKey' => '', // Merchant Private Key 'alipayPublicKey' => '', // Alipay Public Key 'is_sandbox' => true, // Whether to use the Sandbox environment )); ``` Required fields will be mark with `*` ### Online payment - Payment - Pay (Cashier Payment) [](#online-payment---payment---pay-cashier-payment) API: [ac/ams/payment\_cashier](https://global.alipay.com/docs/ac/ams/payment_cashier) DEMO: [pay/cashier](https://p.yzhan.co/alipay-global-sdk-php/example/?type=pay/cashier) ``` use NiZerin\Model\CustomerBelongsTo; use NiZerin\Model\TerminalType; try { $result = $alipayGlobal->payCashier(array( 'customer_belongs_to' => CustomerBelongsTo::ALIPAY_CN, // * Users pay with Alipay Chinese wallet，Optional: ALIPAY_CN / ALIPAY_HK / TRUEMONEY / TNG / GCASH / DANA / KAKAOPAY / EASYPAISA / BKASH 'notify_url' => '', // Asynchronous callback Url 'return_url' => '', // Synchronize callback Url 'amount' => array( 'currency' => 'USD', // Currency of payment 'value' => '1', // Amount of payment ), 'order' => array( 'id' => null, // Order No 'desc' => 'Order Desc', // Order Description 'extend_info' => array( 'china_extra_trans_info' => array( 'business_type' => 'MEMBERSHIP', // Business Type of Order ), ), ), 'payment_request_id' => null, // Cash payments could be null 'settlement_strategy' => array( 'currency' => 'USD', // Currency used for settlement ), 'terminal_type' => TerminalType::WEB, // * Optional: WEB / WAP / APP 'os_type' => null, // OS System Type )); header('Location: ' . $result->normalUrl); // Return URL of the alipay cashier } catch (Exception $e) { echo $e->getMessage(); // Output Error } ``` ### Online Payment - Authorization - Consult [](#online-payment---authorization---consult) API: [ac/ams/authconsult](https://global.alipay.com/docs/ac/ams/authconsult) ``` use NiZerin\Tool\IdTool; use NiZerin\Model\ScopeType; use NiZerin\Model\TerminalType; $auth_state = IdTool::CreateAuthState(); try { $result = $alipayGlobal->authConsult(array( 'customer_belongs_to' => CustomerBelongsTo::ALIPAY_CN, // * Users pay with Alipay Chinese wallet，Optional: ALIPAY_CN / ALIPAY_HK / TRUEMONEY / TNG / GCASH / DANA / KAKAOPAY / EASYPAISA / BKASH 'auth_client_id' => null, // Unique ID of the secondary merchant 'auth_redirect_url' => '', // * URL that User is redirected to after User agrees to authorize 'scopes' => array(ScopeType::AGREEMENT_PAY), // * Optional AGREEMENT_PAY / BASE_USER_INFO / USER_INFO / USER_LOGIN_ID / HASH_LOGIN_ID / SEND_OTP 'auth_state' => $auth_state, // * It will be returned when User agrees to authorize needs to be guaranteed 'terminal_type' => TerminalType::WEB, // * Optional: WEB / WAP / APP 'os_type' => null, // OS System Type )); header('Location: ' . $result->normalUrl); // Return URL of User Authorization page With authCode } catch (Exception $e) { echo $e->getMessage(); // Output Error } ``` ### Online Payment - Authorization - ApplyToken - Using AuthCode [](#online-payment---authorization---applytoken---using-authcode) API: [ac/ams/accesstokenapp](https://global.alipay.com/docs/ac/ams/accesstokenapp) ``` use NiZerin\Model\CustomerBelongsTo; use NiZerin\Model\GrantType; $auth_code = $_GET['authCode'] ?? ''; try { $result = $alipayGlobal->authApplyToken(array( 'grant_type' => GrantType::AUTHORIZATION_CODE, // * Value should be AUTHORIZATION_CODE 'customer_belongs_to' => CustomerBelongsTo::ALIPAY_CN, // * Users pay with Alipay Chinese wallet，Optional: ALIPAY_CN / ALIPAY_HK / TRUEMONEY / TNG / GCASH / DANA / KAKAOPAY / EASYPAISA / BKASH 'auth_code' => $auth_code, // * AuthCode get from return URL of User Authorization page 'refresh_token' => null, // Just leave null )); $access_token = $result->accessToken; // Access token is used for Aduto Debit $access_token_expiry_time = $result->accessTokenExpiryTime; // Access token expiry time $refresh_token = $result->refreshToken; // Refresh token is used for update access token $refresh_token_expiry_time = $result->refreshTokenExpiryTime; // Refresh token expiry time session_start(); // Start Session $_SESSION['access_token'] = $access_token; // Store Accesstoken in session } catch (Exception $e) { echo $e->getMessage(); // Output Error } ``` ### Online Payment - Authorization - ApplyToken - Using RefreshToken [](#online-payment---authorization---applytoken---using-refreshtoken) API: [ac/ams/accesstokenapp](https://global.alipay.com/docs/ac/ams/accesstokenapp) ``` use NiZerin\Model\CustomerBelongsTo; use NiZerin\Model\GrantType; $refresh_token = $_GET['refreshToken'] ?? ''; try { $result = $alipayGlobal->authApplyToken(array( 'grant_type' => GrantType::REFRESH_TOKEN, // * Value should be REFRESH_TOKEN 'customer_belongs_to' => CustomerBelongsTo::ALIPAY_CN, // * Users pay with Alipay Chinese wallet，Optional: ALIPAY_CN / ALIPAY_HK / TRUEMONEY / TNG / GCASH / DANA / KAKAOPAY / EASYPAISA / BKASH 'auth_code' => null, // Just leave null 'refresh_token' => $refresh_token, // * RefreshToken get from authApplyToken Using AuthCode )); $access_token = $result->accessToken; // Access token is used for Aduto Debit $access_token_expiry_time = $result->accessTokenExpiryTime; // Access token expiry time $refresh_token = $result->refreshToken; // Refresh token is used for update access token $refresh_token_expiry_time = $result->refreshTokenExpiryTime; // Refresh token expiry time session_start(); // Start Session $_SESSION['access_token'] = $result->accessToken; // Store Accesstoken in session } catch (Exception $e) { echo $e->getMessage(); // Output Error } ``` ### Online payment - Payment - Pay (Auto Debit) [](#online-payment---payment---pay-auto-debit) API: [ac/ams/payment\_agreement](https://global.alipay.com/docs/ac/ams/payment_agreement) ``` try { session_start(); $result = $alipayGlobal->payAgreement(array( 'notify_url' => '', // Asynchronous callback Url 'return_url' => '', // Synchronous callback Url 'amount' => array( 'currency' => 'USD', // Currency of payment 'value' => '1', // Amount of payment ), 'order' => array( 'id' => null, // Order No 'desc' => 'Order Desc', // Order Description 'extend_info' => array( 'china_extra_trans_info' => array( 'business_type' => 'MEMBERSHIP', // Business Type of Order ), ), ), 'goods' => array( array( 'id' => null, // Goods ID 'name' => 'Goods Name', // Goods Name 'category' => null, // Goods Category 'brand' => null, // Goods Brand 'unit_amount' => null, // Goods Charge Unit 'quantity' => null, // Goods Quantity 'sku_name' => null, // Goods SKU Name ), ), 'merchant' => array( // Secondary merchant Info 'MCC' => null, 'name' => null, 'display_name' => null, 'address' => null, 'register_date' => null, 'store' => null, 'type' => null, ), 'buyer' => array( // Buyer Info 'id' => null, // Buyer ID 'name' => array( 'first_name' => 'David', // * Buyer First Name 'last_name' => 'Chen', // * Buyer Last Name ), 'phone_no' => null, // Buyer Phone Number 'email' => null, // Buyer Email ), 'payment_request_id' => null, // Auto Debit payments could be null 'payment_method' => array( 'payment_method_type' => CustomerBelongsTo::ALIPAY_CN, // * Users pay with Alipay Chinese wallet，Optional: ALIPAY_CN / ALIPAY_HK / TRUEMONEY / TNG / GCASH / DANA / KAKAOPAY / EASYPAISA / BKASH 'payment_method_id' => $_SESSION['access_token'], // * AccessToken returned by applyToken ), 'settlement_strategy' => array( 'currency' => 'USD', // Currency used for settlement ), 'terminal_type' => TerminalType::WEB, // * Optional: WEB / WAP / APP 'os_type' => null, // OS Type )); var_dump($result); // Output Result } catch (Exception $e) { echo $e->getMessage(); // Output Error } ``` ### Online payment - Payment - NotifyPayment [](#online-payment---payment---notifypayment) API: [ac/ams/paymentrn\_online](https://global.alipay.com/docs/ac/ams/paymentrn_online) ``` try { $notify = $alipayGlobal->getNotify(); // Get Asynchronous Payment Notifications // Do something $alipayGlobal->sendNotifyResponseWithRSA(); // Tell Alipay Global the notice has been received and there is no need to send it again } catch (Exception $e) { echo $e->getMessage(); // Output Error } ``` ### Online Payment - Authorization - NotifyAuthorization [](#online-payment---authorization---notifyauthorization) API: [ac/ams/notifyauth](https://global.alipay.com/docs/ac/ams/notifyauth) ``` try { $notify = $alipayGlobal->getNotify(); // Get Asynchronous Authorization Notifications // Do something $rsqBody = $notify->getRsqBody(); // Get Response Body of Notification $authorization_notify_type = $reqBody->authorizationNotifyType; // Determine Notification Type if ($authorization_notify_type === 'AUTHCODE_CREATED') { // If Notification Type is sent AuthCode $_SESSION['auth_code'] = $reqBody->authCode; // Get AuthCode } $alipayGlobal->sendNotifyResponseWithRSA(); // Tell Alipay Global the notice has been received and there is no need to send it again } catch (Exception $e) { echo $e->getMessage(); // Output Error } ``` ### Return Url [](#return-url) ``` /** Return immediately after payment or authorization * After Payment, user will be redirected only * After Authorization, user will be redirected with authCode * Suggestion: The Return URL is only used as a reminder * It's beter to process business in asynchronous payment notification and asynchronous authorization notification **/ echo 'Payment Or Authorization completed'; ``` ### Health Score 22 — LowBetter than 22% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community7 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 1501d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/573fcf255345bc64772d2c61b862bd91ff59089560d78094eb218a4df1d72e35?d=identicon)[nizerin](/maintainers/nizerin) --- Top Contributors [![NiZerin](https://avatars.githubusercontent.com/u/18081398?v=4)](https://github.com/NiZerin "NiZerin (4 commits)") --- Tags sdkalipayAlipay SDKalipay-global ### Embed Badge ![Health badge](/badges/nizerin-alipay-global/health.svg) ``` [![Health](https://phpackages.com/badges/nizerin-alipay-global/health.svg)](https://phpackages.com/packages/nizerin-alipay-global) ``` ### Alternatives [riverslei/payment 支付宝支付、微信支付、招商一网通支付php SDK。方便快速接入，最完整的开源支付 php sdk 2.4k155.5k1](/packages/riverslei-payment)[latrell/alipay 支付宝SDK在Laravel5封装包。 40349.2k](/packages/latrell-alipay) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)