README

B2BinPay API 的 PHP 客户端

接受以下加密货币：Bitcoin，Bitcoin Cash，Ethereum，DASH，Litecoin，Monero，NEO，NEM，Ripple，Cardano，Dogecoin，Zcash，Stellar，EOS，TRON，Binance Coin 以及任何 ERC20 和稳定币，NEO 代币均在一个地方！

要求

• B2BinPay 账户
• PHP >= 7.1（如果您需要 7.0，请使用 版本 1.1.0）
• 启用的 PHP 扩展：cURL，JSON

Composer 安装

安装 B2BinPay API 客户端最简单的方法是通过命令行使用 Composer 要求它

composer require b2binpay/api-php

或通过编辑 composer.json

    {
  "require": {
    "b2binpay/api-php": "^1.2"
  }
}

本地安装

composer install --no-dev
cp .env.example .env

支持的货币

入门

在examples/README.md中查看带注释的示例

创建Provider实例

使用API密钥和秘密访问您的B2BinPay账户

$provider = new B2Binpay\Provider(
    'API_KEY',
    'API_SECRET'
);

测试模式

为了使用测试沙盒，将true作为B2Binpay\Provider的第三个参数传递

$provider = new B2Binpay\Provider(
    'API_KEY',
    'API_SECRET',
    true
);

警告：沙盒和主网关有其自己的密钥和秘密对！

创建账单

支付货币被认为是与您的钱包货币匹配.

创建新的账单

$bill = $provider->createBill(  
        'WALLET_ID',
        'AMOUNT',
        'CURRENCY',
        'LIFETIME',
        'TRACKING_ID',
        'CALLBACK_URL',
        'SUCCESS_URL',
        'ERROR_URL'
  );

货币转换

您可以获取实际汇率并按照您的钱包参数转换支持货币。

获取BASE_CURRENCY的汇率

$rates = $provider->getRates('BASE_CURRENCY', 'RATE_TYPE');

使用实际汇率进行货币转换

$amount = $provider->convertCurrency('AMOUNT', 'BASE_CURRENCY', 'CURRENCY', $rates);

现在您可以提供$amount变量作为createBill()方法的第二个参数，以设置准确的加密货币金额。

添加加价

您可以在现有金额上添加一些加价。

为当前金额设置10%的加价

$amount = $provider->addMarkup($amount, 'CURRENCY', 10);

回调

一旦账单状态发生变化，我们的服务器可以向您配置的回调URL发送回调。此外，您还可以指定跟踪ID，它将随回调返回以识别确切的订单。为此，请向createBill()方法提供附加参数

$bill = $provider->createBill(
        'WALLET_ID',
        $amount,
        'CURRENCY',
        'LIFETIME',
        '202009051801',
        'https://my.callback.url/callback.php'
    );

警告：如果指定，您的回调URL应该返回状态为200的消息“OK”。在此之前，将不会认为付款已完成！

header('HTTP/1.1 200 OK');
exit('OK');

回调验证

您可以通过将其与$provider->verifySign()方法的输出进行比较来验证回调请求头

$verifySign = $provider->verifySign($_POST['sign']['time'], $_POST['sign']['hash']);
if (!$verifySign) {
    header('HTTP/1.1 401 Unauthorized');
    exit();
}

警告：对于每个回调，$ _POST ['sign'] ['hash']将生成一个新的哈希值 - 如果您收到了之前已经使用过的$ _POST ['sign'] ['hash']，则应该抛出与签名验证相同的错误

回调体

账单回调请求将包含以下数据

{
  "data": {
    "id": BILL_ID,
    "url": URL_TO_BILL_PAYMENT_PAGE,
    "address": BLOCKCHAIN_ADDRESS,
    "created": TIME,
    "expired": TIME
    |
    NULL,
    "status": BILL_STATUS,
    "tracking_id": TRACKING_ID,
    "callback_url": URL
    |
    NULL
    "amount": AMOUNT_MULTIPLIED_BY_TEN_IN_POW,
    "actual_amount": ALREADY_PAID_AMOUNT_MULTIPLIED_BY_TEN_IN_POW,
    "pow": POW,
    "message": MESSAGE
    |
    NULL,
    "transactions": [
      {
        "id": TRANSACTION_ID,
        "bill_id": BILL_ID,
        "created": TIME,
        "amount": TRANSACTION_AMOUNT_MULTIPLIED_BY_TEN_IN_POW
        ",
        "pow": POW,
        "status": TRANSACTION_STATUS,
        "transaction": HASH_TRANSACTION_IN_BLOCKCHAIN,
        "type": 0,
        "currency": {
          "iso": ISO_CODE_CURRENCY,
          "alpha": SYMBOL_CURRENCY
        }
      }
    ],
    "currency": {
      "iso": ISO_CODE_CURRENCY,
      "alpha": SYMBOL_CURRENCY
    },
    "sign": {
      "time": TIME,
      "hash": HASH
    }
  }
}

取款回调请求将包含以下数据

{
  "data": {
    "id": WITHDRAW_ID,
    "virtual_wallet_id": VIRTUAL_WALLET_ID,
    "with_fee": INCLUDE_COMMISSION_IN_WITHDRAW,
    "created": TIME,
    "address": BLOCKCHAIN_ADDRESS,
    "amount": AMOUNT_MULTIPLIED_BY_TEN_IN_POW,
    "fee": BLOCKCHAIN_FEE_MULTIPLIED_BY_TEN_IN_POW,
    "pow": POW,
    "status": WITHDRAW_STATUS,
    "transaction": HASH_TRANSACTION_IN_BLOCKCHAIN
    |
    NULL
    "tracking_id": TRACKING_ID
    |
    NULL,
    "unique_id": UNIQUE_WITHDRAW_ID,
    "callback_url": URL
    |
    NULL,
    "message": MESSAGE
    |
    NULL,
    "currency": {
      "iso": ISO_CODE_CURRENCY,
      "alpha": SYMBOL_CURRENCY
    },
    "sign": {
      "time": TIME,
      "hash": HASH
    }
  }
}

创建取款

从虚拟钱包中，您可以向任何区块链进行提款，为此您需要指定地址和货币.

创建新的提款

$bill = $provider->createWithdrawal(  
        'VIRTUAL_WALLET_ID',
        'AMOUNT',
        'CURRENCY',
        'ADDRESS',
        'UNIQUE_ID',
        'TRACKING_ID',
        'CALLBACK_URL',
        'MESSAGE',
        'WITH_FEE'
    );

系统状态列表

账单状态列表

交易状态列表

提款状态列表

转账状态列表

转账类型列表

许可证

B2BinPay\API-PHP遵循MIT许可证。