kevinkl3/neteller

Neteller API

1.0.1 2017-11-17 08:08 UTC

This package is not auto-updated.

Last update: 2024-09-29 03:31:18 UTC


README

注意:这是从 GrandMasterX/neteller 分支出来的

NETELLER REST API PHP 库

简介

NETELLER PHP 库为 PHP 开发者提供了一种轻松集成 NETELLER REST API 的方法。它是一个客户端库,提供了与 NETELLER REST API 中的资源相对应的 PHP 类。

安装

要安装此版本:composer require kevinkl3/neteller

要安装原始版本:composer require GrandMasterX/neteller

配置

您需要使用 setApiCredentials 方法定义认证详细信息。

示例

$url = 'https://test.api.neteller.com/';
$clientId = 'AAAAAAAAAAAAAAAAA';
$clientSecret = 'BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB';

// Parent class
$api = new NetellerApi();
$api->setApiCredentials($url, $clientId, $clientSecret);

// All other subclases
$createOrder = new CreateOrder();
$createOrder->setApiCredentials($url, $clientId, $clientSecret);

详细模式(cURL)

使用 setVerbose 方法启用或禁用 cURL 详细模式。

示例

$api->setVerbose(true);

NetellerAPI 类

一个父类,所有下面的类都扩展自它。

方法

  • getIP() - 使用外部服务返回托管脚本的服务器的出站 IP 地址。对于调试“invalid_client” API 错误很有用。
  • getUrl(string $url) - 执行对 NETELLER API 的 URL 的 GET 请求并返回结果。当实现 webhooks 时很有用。
  • getToken_ClientCredentials() - 返回一个新的访问令牌 - “client_credentials”授权类型。
  • getToken_AuthCode(string $authCode, string $redirectUri) - 返回一个新的访问令牌 - “auth_code”授权类型。
  • getToken_RefreshToken(string $refreshToken) - 使用刷新令牌返回一个新的访问令牌。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

use NetellerAPI\NetellerAPI;

$api = new NetellerApi();
$ip = $api->getIP();
var_dump($ip);

它也可以在子类上下文中使用

use NetellerAPI\RequestPayment;

$url = 'https://test.api.neteller.com/';
$clientId = 'AAAAAAAAAAAAAAAAA';
$clientSecret = 'BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB';

$deposit = new RequestPayment();
$deposit->setApiCredentials($url, $clientId, $clientSecret);


 $deposit->setPaymentMethodValue('netellertest_USD@neteller.com')
          ->setVerificationCode(270955)
          ->setTransactionMerchantRefId('adfiu1i23478172349a')
          ->setTransactionAmount(1234)
          ->setTransactionCurrency('USD');

$result = $deposit->doRequest();
  $ip = $deposit->getIP();

  var_dump($result);
  var_dump($ip);

RequestPayment 类

创建一个新的入账转账支付。

方法

  • setPaymentMethodValue(string $paymentMethod) - 设置成员的电子邮件或 12 位 NETELLER 账户 ID。
  • setVerificationCode(string $verificationCode) - 设置成员的安全 ID 或 Google Authenticator OTP。
  • setTransactionMerchantRefId(string $merchantRefId) - 设置商户参考 ID。
  • setTransactionAmount(int $transactionAmount) - 设置交易金额。
  • setTransactionCurrency(string $transactionCurrency) - 设置交易货币。
  • setExpand(string $expandObjects) - 要在 NETELLER REST API 响应中展开的对象的逗号分隔名称列表。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$deposit = new NetellerAPI\RequestPayment();
$deposit->setPaymentMethodValue('netellertest_USD@neteller.com')
        ->setVerificationCode(270955)
        ->setTransactionMerchantRefId('adfiu1i23478172349a')
        ->setTransactionAmount(1234)
        ->setTransactionCurrency('USD');
$result = $deposit->doRequest();
var_dump($result);

CreatePayment 类

创建一个新的出账支付。

方法

  • setPayeeProfileEmail(string $payeeProfileEmail) - 设置收到支付的成员的电子邮件。
  • setTransactionAmount(int $transactionAmount) - 设置交易金额。
  • setTransactionCurrency(string $transactionCurrency) - 设置交易货币。
  • setTransactionMerchantRefId(string $transactionMerchantRefId) - 设置商户参考 ID。
  • setMessage(string $message) - 设置将显示给成员的消息,通知他们有挂起的转账。
  • setExpand(string $expandObjects) - 要在 NETELLER REST API 响应中展开的对象的逗号分隔名称列表。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$withdrawal = new NetellerAPI\CreatePayment();
$withdrawal->setPayeeProfileEmail('netellertest_USD@neteller.com')
           ->setTransactionAmount(1234)
           ->setTransactionCurrency('USD')
           ->setTransactionMerchantRefId('adfiu1i23478172349W2')
           ->setMessage('sample message');
$result = $withdrawal->doRequest();
var_dump($result);

LookupPayment 类

返回关于先前付款请求的详细信息。

方法

  • setTransactionId(string $transactionId) - 设置要查找的交易 NETELLER 交易 ID。您可以使用此方法或使用 "setMerchantRefId"。
  • setMerchantRefId(string $merchantRefId) - 设置要查找的交易商户参考 ID。您可以使用此方法或使用 "setTransactionId"。
  • setExpand(string $expandObjects) - 要在 NETELLER REST API 响应中展开的对象的逗号分隔名称列表。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$lookup = new NetellerAPI\LookupPayment();
$lookup->setTransactionId('850430740226289')
       ->setExpand('customer');
$result = $lookup->doRequest();
var_dump($result);

CreateOrder 类

为 NETELLERgo! 创建付款订单。您需要将客户重定向到返回的 URL 以启动托管快速结账流程并收集付款。

方法

  • setOrderMerchantRefId(string $orderMerchantRefId) - 设置商户参考 ID。
  • setOrderTotalAmount(int $orderTotalAmount) - 设置订单的总金额。
  • setOrderCurrency(string $orderCurrency) - 设置订单的货币。
  • setOrderLang(string $orderLang) - 设置托管付款页面的语言。
  • setOrderCustomerIp(string $orderCustomerIp) - 设置客户的 IP 地址。
  • setItems(array $item) - 设置您请求付款的项目。
  • setFees(array $fee) - 设置此订单的费用。
  • setTaxes(array $tax) - 设置此订单的税。
  • setPaymentMethods(array $paymentMethod) - 设置此订单允许的支付方式。
  • setRedirectOnSuccess(string $url) - 设置成功重定向 URL。
  • setRedirectOnCancel(string $url) - 设置取消重定向 URL。
  • setBillingDetailsEmail(string $billingDetailsEmail) - 设置客户的电子邮件地址。
  • setBillingDetailsCountry(string $billingDetailsCountry) - 设置客户居住国(ISO 3166-1 Alpha 2-code)。
  • setBillingDetailsFirstName(string $billingDetailsFirstName) - 设置客户的首名。
  • setBillingDetailsLastName(string $billingDetailsLastName) - 设置客户的姓氏。
  • setBillingDetailsCity(string $billingDetailsCity) - 设置客户居住的城市。
  • setBillingDetailsAddress1(string $billingDetailsAddress1) - 设置客户的地址(行 1)。
  • setBillingDetailsAddress2(string $billingDetailsAddress2) - 设置客户的地址(行 2)。
  • setBillingDetailsAddress3(string $billingDetailsAddress3) - 设置客户的地址(行 3)。
  • setBillingDetailsCountrySubDivisionCode(string $countrySubDivisionCode) - 设置客户的国分区代码。ISO 3166-2 代码表示州/省/区或其他表示客户国分区的值。
  • setBillingDetailsPostCode(string $billingDetailsPostCode) - 设置客户的邮政编码。
  • setBillingDetailsLang(string $billingDetailsLang) - 设置客户首选的沟通语言。
  • setAttributes(array $attribute) - 设置此订单的附加属性。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getOrderId() - 返回 NETELLER 订单 ID 或 null(如果尚未调用 doRequest() 或发生错误)
  • getRedirectUrl() - 返回客户端需要重定向以完成付款的 URL。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$order = new NetellerAPI\CreateOrder();
$order->setOrderMerchantRefId('adfiu1i23478172349o1')
      ->setOrderTotalAmount(2099)
      ->setOrderCurrency('USD')
      ->setOrderLang('en_US')
      ->setItems(array
                    (
                        "quantity" => 1,
                        "name" => "Item A",
                        "description" => "Lorem ipsum dolor sit amet",
                        "sku" => "XYZPART1",
                        "amount" => 1000
                    )
                )
      ->setItems(array
                    (
                        "quantity" => 2,
                        "name" => "Item B",
                        "description" => "Consectetur adipiscing elit",
                        "sku" => "XYZPART2",
                        "amount" => 200
                    )
                )
      ->setFees(array
                    (
                        "feeName" => "Setup Fee",
                        "feeAmount" => 500
                    )
                )
      ->setTaxes(array
                    (
                        "taxName" => "VAT",
                        "taxAmount" => 199
                    )
                )
      ->setPaymentMethods(array
                (
                    "type" => "onlinebanking",
                    "value" => "sofortbanking"
                )
            )
      ->setRedirectOnSuccess("https://example.com/success.html")
      ->setRedirectOnCancel("https://example.com/cancel.html")
      ->setBillingDetailsEmail("netellertest_USD@neteller.com")
      ->setBillingDetailsCountry("DE")
      ->setBillingDetailsFirstName("John")
      ->setBillingDetailsLastName("Smith")
      ->setBillingDetailsCity("Calgary")
      ->setBillingDetailsAddress1("address line 1")
      ->setBillingDetailsAddress2("address line 2")
      ->setBillingDetailsAddress3("address line 3")
      ->setBillingDetailsCountrySubDivisionCode("AB")
      ->setBillingDetailsPostCode("T8A22J")
      ->setBillingDetailsLang("en");
$result = $order->doRequest();
$redirectUrl = $order->getRedirectUrl();
var_dump($result);
var_dump($redirectUrl);

LookupOrder 类

返回关于先前订单请求的详细信息。

方法

  • setOrderId(string $orderId) - 设置订单 ID。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$lookup = new NetellerAPI\LookupOrder();
$lookup->setOrderId("ORD_1f21ca9d-e647-46bc-9dde-91c70632e587");
$result = $lookup->doRequest();
var_dump($result);

LookupOrderInvoice 类

返回关于订单发票的详细信息。

方法

  • setOrderId(string $orderId) - 设置订单 ID。
  • setExpand(string $expandObjects) - 要在 NETELLER REST API 响应中展开的对象的逗号分隔名称列表。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$lookup = new NetellerAPI\LookupOrderInvoice();
$lookup->setOrderId("ORD_5c0023d3-c928-4771-9016-1fc169283b0f")
       ->setExpand("customer,order");
$result = $lookup->doRequest();
var_dump($result);

CreateCustomer 类

使用您的数据库中的信息预填充 NETELLER 注册页面,以便您可以加快注册过程。

方法

  • setEmail(string $email) - 设置客户的电子邮件。
  • setFirstName(string $firstName) - 设置客户的首名。
  • setLastName(string $lastName) - 设置客户的姓氏。
  • setAddress1(string $address1) - 设置客户的地址行1。
  • setAddress2(string $address2) - 设置客户的地址行2。
  • setAddress3(string $address3) - 设置客户的地址行3。
  • setCity(string $city) - 设置客户的所在城市。
  • setCountry(string $country) - 设置客户的所在国家。ISO 3166-1 Alpha 2-code。
  • setCountrySubDivisionCode(string $countrySubDivisionCode) - 设置客户的州/省。ISO 3166-2 code。
  • setPostCode(string $postCode) - 设置客户的邮政编码。
  • setGender(string $gender) - 设置客户的性别。
  • setDobDay(string $dobDay) - 设置客户的出生日期日。
  • setDobMonth(string $dobMonth) - 设置客户的出生日期月。
  • setDobYear(string $dobYear) - 设置客户的出生日期年。
  • setLanguage(string $language) - 设置客户的首选语言。
  • setCurrency(string $currency) - 设置客户的首选货币。
  • setMobile(string $mobile) - 设置客户的手机号码。
  • setLandLine(string $landLine) - 设置客户的固定电话。
  • setBtag(string $btag) - 设置btag,用于跟踪联盟。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getRedirectUrl() - 返回客户端需要重定向以完成注册的URL。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$signup = new NetellerAPI\CreateCustomer();
$signup->setEmail("john.smith@example.com")
       ->setFirstName("John")
       ->setLastName("Smith")
       ->setAddress1("address line 1")
       ->setAddress2("address line 2")
       ->setAddress3("address line 3")
       ->setCity("Calgary")
       ->setCountry("CA")
       ->setCountrySubDivisionCode("AB")
       ->setPostCode("T8A22J")
       ->setGender("m")
       ->setDobDay("31")
       ->setDobMonth("01")
       ->setDobYear("1975")
       ->setLanguage("en_US")
       ->setCurrency("EUR")
       ->setMobile("14035552333")
       ->setLandLine("14032332333")
       ->setLinkBackUrl("https://example.com/")
       ->setBtag("A_234B_345C_");
$response = $signup->doRequest();
$redirectUrl = $signup->getRedirectUrl();
var_dump($response);
var_dump($redirectUrl);

LookupCustomer 类

查找特定客户的详细信息。

方法

  • setAccountId(string $accountId) - 设置客户的账户ID。您可以使用此方法或 "setCustomerId" 和 "setEmail"。
  • setCustomerId(string $customerId) - 设置客户的客户ID。您可以使用此方法或 "setAccountId" 和 "setEmail"。
  • setEmail(string $email) - 设置客户的电子邮件。您可以使用此方法或 "setAccountId" 和 "setCustomerId"。
  • setRefreshToken(string $refreshToken) - 设置用于获取访问令牌的刷新令牌。您可以使用此方法或使用 "setAuthCode"。此方法仅在您想要在默认作用域之外接收客户数据时使用。
  • setAuthCode(string $authCode) - 设置用于获取访问令牌的认证代码。您可以使用此方法或使用 "setRefreshToken"。此方法仅在您想要在默认作用域之外接收客户数据时使用。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$lookup = new NetellerAPI\LookupCustomer();
$lookup->setCustomerId("453523712313")
       ->setRefreshToken("0.AgAAAU0yy4sHAAAAB1jwsOC9J7TBAYynTble-g2fdC-d.7xIAyXxQWsDaiLzjY4qimsqfyYU");
$result = $lookup->doRequest();
var_dump($result);

CreatePlan 类

创建订阅计划。

方法

  • setPlanId(string $planId) - 设置计划的唯一ID。
  • setPlanName(string $planName) - 设置计划名称。
  • setInterval(int $interval) - 设置每次计费尝试之间的间隔次数。
  • setIntervalType(string $intervalType) - 设置计划订阅者将被计费的时间频率(每日、每周、每月、每年)。
  • setIntervalCount(int $intervalCount) - 设置合同在间隔中的长度。
  • setAmount(int $amount) - 设置每次周期性付款的金额。
  • setCurrency(string $currency) - 设置客户将被计费的货币。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$plan = new NetellerAPI\CreatePlan();
$plan->setPlanId("MONTHLYGREENPLAN")
     ->setPlanName("Sample Premier Monthly Membership")
     ->setInterval(3)
     ->setIntervalType("monthly")
     ->setIntervalCount(4)
     ->setAmount(2995)
     ->setCurrency("USD");
$result = $plan->doRequest();
var_dump($result);

LookupPlan 类

返回之前创建的订阅计划的详细信息。

方法

  • setPlanId(string $planId) - 设置计划ID。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$lookup = new NetellerAPI\LookupPlan();
$lookup->setPlanId("MONTHLYGREENPLAN");
$result = $lookup->doRequest();
var_dump($result);

CancelPlan 类

取消之前创建的订阅计划。

方法

  • setPlanId(string $planId) - 设置计划ID。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$plan = new NetellerAPI\CancelPlan();
$plan->setPlanId("MONTHLYGREENPLAN");
$result = $plan->doRequest();
var_dump($result);

删除计划

删除之前创建的订阅计划。

方法

  • setPlanId(string $planId) - 设置计划ID。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$plan = new NetellerAPI\DeletePlan();
$plan->setPlanId("MONTHLYGREENPLAN");
$result = $plan->doRequest();
var_dump($result);

ListPlans 类

返回所有计划的列表。

方法

  • setLimit(int $limit) - 设置要返回的记录数。
  • setOffset(int $offset) - 设置结果偏移量。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$plans = new NetellerAPI\ListPlans();
$plans->setLimit(10)
      ->setOffset(0);
$result = $plans->doRequest();
var_dump($result);

CreateSubscription 类

将现有的NETELLER账户持有人注册到您的订阅计划之一。

方法

  • setPlanId(string $planId) - 设置计划ID。
  • setCustomerId(string $customerId) - 设置要订阅的客户的客户ID。
  • setStartDate(string $startDate) - 设置订阅的开始日期。日期需要使用ISO 8601格式(UTC)。
  • setRefreshToken(string $refreshToken) - 设置用于获取访问令牌的刷新令牌。您可以使用此方法或使用“setAuthCode”。
  • setAuthCode(string $authCode) - 设置用于获取访问令牌的认证代码。您可以使用此方法或使用“setRefreshToken”。
  • setRedirectUri(string $redirectUri) - 设置重定向URI。
  • setExpand(string $expandObjects) - 要在 NETELLER REST API 响应中展开的对象的逗号分隔名称列表。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

使用授权代码

$subscription = new NetellerAPI\CreateSubscription();
$subscription->setPlanId("MONTHLYGREENPLAN")
             ->setAccountProfileEmail("netellertest_USD@neteller.com")
             ->setStartDate("2015-05-09T00:00:00Z")
             ->setAuthCode("0.AAAAAU0yjMR5AAAAAAAEk-B1A0yk5HA7RZkwz9zQYRFN.eNw8W12CqB06b2Qc2rvr3vUyc-g")
             ->setRedirectUri("https://example.com/")
             ->setExpand("plan,customer");
$result = $subscription->doRequest();
var_dump($result);

使用刷新令牌

$subscription = new NetellerAPI\CreateSubscription();
$subscription->setPlanId("MONTHLYGREENPLAN")
             ->setAccountProfileEmail("netellertest_USD@neteller.com")
             ->setStartDate("2015-05-09T00:00:00Z")
             ->setRefreshToken("0.AgAAAU0yy4sHAAAAB1jwsOC9J7TBAYynTble-g2fdC-d.7xIAyXxQWsDaiLzjY4qimsqfyYU")
             ->setRedirectUri("https://example.com/")
             ->setExpand("plan,customer");
$result = $subscription->doRequest();
var_dump($result);

LookupSubscription 类

返回关于之前创建的订阅的详细信息。

方法

  • setSubscriptionId(string $subscriptionId) - 设置订阅ID。
  • setExpand(string $expandObjects) - 要在 NETELLER REST API 响应中展开的对象的逗号分隔名称列表。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$lookup = new NetellerAPI\LookupSubscription();
$lookup->setSubscriptionId("180")
       ->setExpand("plan,customer");
$result = $lookup->doRequest();
var_dump($result);

CancelSubscription 类

取消之前创建的订阅。

方法

  • setSubscriptionId(string $subscriptionId) - 设置订阅ID。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$subscription = new NetellerAPI\CancelSubscription();
$subscription->setSubscriptionId("181");
$result = $subscription->doRequest();
var_dump($result);

ListSubscriptions 类

列出所有之前创建的订阅。

方法

  • setLimit(int $limit) - 设置要返回的记录数。
  • setOffset(int $offset) - 设置结果偏移量。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$subscriptions = new NetellerAPI\ListSubscriptions();
$subscriptions->setLimit(10)
              ->setOffset(0);
$result = $subscriptions->doRequest();
var_dump($result);

LookupSubscriptionInvoice 类

查找订阅发票。

方法

  • setSubscriptionId(string $subscriptionId) - 设置订阅ID。
  • setInvoiceNumber(int $invoiceNumber) - 设置发票号。
  • setExpand(string $expandObjects) - 要在 NETELLER REST API 响应中展开的对象的逗号分隔名称列表。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$lookup = new NetellerAPI\LookupSubscriptionInvoice();
$lookup->setSubscriptionId(166)
       ->setInvoiceNumber(42)
       ->setExpand("customer, subscription");
$result = $lookup->doRequest();
var_dump($result);

LookupAllSubscriptionInvoices 类

查找所有订阅发票。

方法

  • setSubscriptionId(string $subscriptionId) - 设置订阅ID。
  • setLimit(int $limit) - 设置要返回的记录数。
  • setOffset(int $offset) - 设置结果偏移量。
  • doRequest() - 执行 API 请求。返回 JSON 解码的 NETELLER REST API 响应对象,或在发生错误时返回“(bool)false”。
  • getExecutionErrors() - 返回由 NETELLER REST API 返回的错误数组。

示例

$lookup = new NetellerAPI\LookupAllSubscriptionInvoices();
$lookup->setSubscriptionId(166)
       ->setLimit(10)
       ->setOffset(0);
$result = $lookup->doRequest();
var_dump($result);

WebhookHandler 类

处理传入的webhook请求。

方法

  • handleRequest() - 接收webhook请求并调用回调函数,传递webhook数据。您需要给回调函数(s)与您订阅的webhook(s)相同的名称。请参阅REST API指南以获取所有webhook名称的列表。

示例

$webhook = new NetellerAPI\WebhookHandler();
$webhook->handleRequest();

function payment_succeeded($data){
    $api = new NetellerAPI\NetellerAPI();
    $result = $api->getUrl($data->links[0]->url);
    //do something with the response here
}

测试账户

白名单IP

  • 5.62.88.97 – webhook生产
  • 5.62.88.64/27 – 整个生产IP范围
  • 206.172.46.138 – webhook沙盒