README

这个库允许您通过您的系统连接到https://apidocs.urpay.com.br/。

注意：这不是官方库。然而，我认为它是功能性的，因为我总是添加新的工具。

注意 已在 PHP 7.1.8 及以上版本中测试，不保证在早期版本中运行良好。

API 文档

API Rest 的官方文档在此：https://apidocs.urpay.com.br/

安装

您可以使用 Composer

Composer

最方便的方法是通过composer。如果您还没有安装 composer，请按照说明进行操作。

在项目根目录中运行以下命令以安装库

composer require phabloraylan/urpay-php-sdk

将自动加载器包含到您的项目中

require_once 'vendor/autoload.php';

查询余额

获取账户余额信息

use URPay\Client;
use URPay\Services\Balance\BalanceService;

$client = new Client();
$client->setTokenCommon("TOKEN_COMUM");

$balanceResponse = BalanceService::getBalance($client);
echo $balanceResponse->getBalance();//saldo
echo $balanceResponse->getBlocked();//saldo bloqueado
echo $balanceResponse->getFuture();//saldo futuro
echo $balanceResponse->getGiftcard();//saldo de vale-presente

查询交易

获取交易信息

use URPay\Client;
use URPay\Services\InternalTransfer\InternalTransferService;

$client = new Client();
$client->setTokenCommon("TOKEN_COMUM");

$transf = "ID_TRANSFERÊNCIA";
$transfResponse = InternalTransferService::getInternalTransfer($client, $transf);

echo $transfResponse->getValue();//valor (resultado em decimal ex.: 10.00)

echo $transfResponse->getId();

$cryptoCoins = $transfResponse->getCryptoCoins();
echo $cryptoCoins->getTransactionHash();

echo $transfResponse->getUpdated();
echo $transfResponse->isPayment();
echo $transfResponse->getStatus();
echo $transfResponse->getContested();
echo $transfResponse->isReversed();
echo $transfResponse->isReversal();
echo $transfResponse->isCryptoCoins();

// De quem saiu a transação
$sendFrom = $transfResponse->getSendFrom();
echo $sendFrom->getId();
echo $sendFrom->getUser();
echo $sendFrom->getName();

$sendFromDocument = $sendFrom->getDocument();
echo $sendFromDocument->getDocument();
echo $sendFromDocument->getType();

// Para quem foi a transação
$sendTo = $transfResponse->getSendTo();
echo $sendTo->getId();
echo $sendTo->getUser();
echo $sendTo->getName();

$sendToDocument = $sendTo->getDocument();
echo $sendToDocument->getDocument();
echo $sendToDocument->getType();

echo $transfResponse->getRegistered();

//retorma uma instancia de Carbon\Carbon usuando a biblioteca composer require nesbot/carbon
$regiteredCarbon = $transfResponse->getRegisteredCarbon();

// Verificar se a hash tem sua transferência 100% confirmada e sem contestação:
if($transfResponse->isPaymentSuccess()){
    //confirmada
}

查询用户

获取用户信息

use URPay\Client;
use URPay\Services\User\UserService;

$client = new Client();
$client->setTokenCommon("TOKEN_COMMON");

$user_id = "@fulanodetal" // Exemplo: @fulanodetal ou fulanodetal
$userResponse = UserService::getUser($client, $user_id);

echo $userResponse->getId();//_id do usuário
echo $userResponse->getUser();
echo $userResponse->getName();
echo $userResponse->getGender();

// Documento do usuário
$userDocument = $userResponse->getDocument();
echo $userDocument->getDocument();
echo $userDocument->getType();

// Endereço do usuário
$userAddress = $userResponse->getAddress();
echo $userAddress->getCity();
echo $userAddress->getState();
echo $userAddress->getCountry();

// Caso deseje consultar usuário por documento, use o terceiro parametro com a constante UserService::DOCUMENT, exemplo: 

$client = new Client();
// O token precisa ser de consulta a documento
$client->setTokenDoc("TOKEN_DOC");

$doc = "12345678900" // Exemplo: 12345678900 ou 123.456.789-00 (Com máscara também aceito)
$userResponse = UserService::getUser($client, $doc,UserService::DOCUMENT);

// Todos os metódos de consulta por usuário pode ser usado e tambem o de e-mail, que só retorna quando está com a constante UserService::DOCUMENT
echo $userResponse->getEmail();

目前转账 API 正在处理稳定性问题，当恢复正常时，我会在这里添加，并完成所有方法的文档。