包简介

PHP SDK for the PromisePay API

README 文档

README

Note: The api only responds to the models which are included with the php package.

Installation
Configuration
Examples
Async and Wrappers
- Async
- Wrappers
Contributing

Installation

Composer

You can include this package via Composer.

{
  "require": {
    "promisepay/promisepay-php": "2.*"
  }
}

Install the package.

composer install

Require the package in the controller where you'll be using it.

use PromisePay\PromisePay;

Manual Installation

Download the latest release from GitHub, then require the package in the relevant controller.

use PromisePay\PromisePay;

Prerequisites

PHP 5.3 or above
curl and json extensions must be enabled

Configuration

Before interacting with PromisePay API, you'll need to create a prelive account and get an API token.

Afterwards, you need to declare environment, login (your email address) and password (API token), thus:

PromisePay::Configuration()->environment('prelive'); // Use 'production' for the production environment.
PromisePay::Configuration()->login('your_email_address');
PromisePay::Configuration()->password('your_token');

Examples

Tokens

Request session token

The below example shows the request for a marketplace configured to have the Item and User IDs generated automatically for them.

$token = PromisePay::Token()->requestSessionToken(array(
	'current_user'           => 'seller',
	'item_name'              => 'Test Item',
	'amount'                 => '2500',
	'seller_lastname'        => 'Seller',
	'seller_firstname'       => 'Sally',
	'buyer_lastname'         => 'Buyer',
	'buyer_firstname'        => 'Bobby',
	'buyer_country'          => 'AUS',
	'seller_country'         => 'USA',
	'seller_email'           => 'sally.seller@promisepay.com',
	'buyer_email'            => 'bobby.buyer@promisepay.com',
	'fee_ids'                => '',
	'payment_type_id'        => '2'
));

Items

Create an item

$item = PromisePay::Item()->create(array(
    "id"              => 'ITEM_ID',
    "name"            => 'Test Item #1',
    "amount"          => 1000,
    "payment_type_id" => 1,
    "buyer_id"        => 'BUYER_ID',
    "seller_id"       => 'SELLER_ID',
    "description"     => 'Description'
));

Get an item

$item = PromisePay::Item()->get('ITEM_ID');

Get a list of items

$items = PromisePay::Item()->getList(array(
	'limit' => 20,
	'offset' => 0
));

Update an item

$item = PromisePay::Item()->update('ITEM_ID', array(
    "id"              => 'ITEM_ID',
    "name"            => 'Test Item #1',
    "amount"          => 1000,
    "payment_type_id" => 1,
    "buyer_id"        => 'BUYER_ID',
    "seller_id"       => 'SELLER_ID',
    "description"     => 'Description'
));

Delete an item

$item = PromisePay::Item()->delete('ITEM_ID');

Get an item status

$item = PromisePay::Item()->getStatus('ITEM_ID');

Get an item's buyer

$user = PromisePay::Item()->getBuyer('ITEM_ID');

Get an item's seller

$user = PromisePay::Item()->getSeller('ITEM_ID');

Get an item's fees

$fees = PromisePay::Item()->getListOfFees('ITEM_ID');

Get an item's transactions

$transactions = PromisePay::Item()->getListOfTransactions('ITEM_ID');

Get an item's wire details

$wireDetails = PromisePay::Item()->getWireDetails('ITEM_ID');

Get an item's BPAY details

$bPayDetails = PromisePay::Item()->getBPayDetails('ITEM_ID');

Item Actions

Make payment

$item = PromisePay::Item()->makePayment('ITEM_ID', array(
	'account_id' => 'BUYER_ACCOUNT_ID'
));

Request payment

$item = PromisePay::Item()->requestPayment('ITEM_ID');

Release payment

$item = PromisePay::Item()->releasePayment('ITEM_ID');

Request release

$item = PromisePay::Item()->requestRelease('ITEM_ID');

Cancel

$item = PromisePay::Item()->cancelItem('ITEM_ID');

Acknowledge wire

$item = PromisePay::Item()->acknowledgeWire('ITEM_ID');

Acknowledge PayPal

$item = PromisePay::Item()->acknowledgePayPal('ITEM_ID');

Revert wire

$item = PromisePay::Item()->revertWire('ITEM_ID');

Request refund

$item = PromisePay::Item()->requestRefund('ITEM_ID', array(
	'refund_amount' => 1000,
	'refund_message' => 'Frame already constructed.'
));

Refund

$item = PromisePay::Item()->refund('ITEM_ID', array(
	'refund_amount' => 1000,
	'refund_message' => 'Stable deck refund.'
));

Decline refund

$declineRefund = PromisePay::Item()->declineRefund(
    'ITEM_ID'
);

Raise Dispute

$raiseDispute = PromisePay::Item()->raiseDispute(
    'ITEM_ID',
    'BUYER_ID'
);

Request Dispute Resolution

$requestDisputeResolution = PromisePay::Item()->requestDisputeResolution(
    'ITEM_ID'
);

Resolve Dispute

$resolveDispute = PromisePay::Item()->resolveDispute(
    'ITEM_ID'
);

Escalate Dispute

$resolveDispute = PromisePay::Item()->escalateDispute(
    'ITEM_ID'
);

Request Tax Invoice

$requestTaxInvoice = PromisePay::Item()->requestTaxInvoice(
    'ITEM_ID'
);

List Item Batch Transactions

$batchTransactions = PromisePay::Item()->listBatchTransactions('ITEM_ID');

Send Tax Invoice

$sendTaxInvoice = PromisePay::Item()->sendTaxInvoice(
    'ITEM_ID'
);

Users

Create a user

$user = PromisePay::User()->create(array(
    'id'            => 'USER_ID',
    'first_name'    => 'UserCreateTest',
    'last_name'     => 'UserLastname',
    'email'         => 'email@google.com',
    'mobile'        => '5455400012',
    'address_line1' => 'a_line1',
    'address_line2' => 'a_line2',
    'state'         => 'state',
    'city'          => 'city',
    'zip'           => '90210',
    'country'       => 'AUS'
));

Get a user

$user = PromisePay::User()->get('USER_ID');

Get a list of users

$users = PromisePay::User()->getList(array(
	'limit' => 20,
	'offset' => 0
));

Update a user

$user = PromisePay::User()->update('USER_ID', array(
    'id'            => 'USER_ID',
    'first_name'    => 'UserCreateTest',
    'last_name'     => 'UserLastname',
    'email'         => 'email@google.com',
    'mobile'        => '5455400012',
    'address_line1' => 'a_line1',
    'address_line2' => 'a_line2',
    'state'         => 'state',
    'city'          => 'city',
    'zip'           => '90210',
    'country'       => 'AUS'
));

Get a user's card accounts

$accounts = PromisePay::User()->getListOfCardAccounts('USER_ID');

Get a user's PayPal accounts

$accounts = PromisePay::User()->getListOfPayPalAccounts('USER_ID');

Get a user's bank accounts

$accounts = PromisePay::User()->getListOfBankAccounts('USER_ID');

Get a user's items

$items = PromisePay::User()->getListOfItems('USER_ID');

Show User Wallet Account

$accounts = PromisePay::User()->getListOfWalletAccounts('USER_ID');

Set a user's disbursement account

$account = PromisePay::User()->setDisbursementAccount('USER_ID', array(
    'account_id' => 'ACCOUNT_ID'
));

Wallet Accounts

Show Wallet Account

$wallet = PromisePay::WalletAccounts()->show('WALLET_ID');

Withdraw Funds

// Withdraw to PayPal

// Authorize bank account to be used as a funding source
$authority = PromisePay::DirectDebitAuthority()->create(
    array(
        'account_id' => 'SOURCE_BANK_ID',
        'amount'     => 100
    )
);

$withdrawal = PromisePay::WalletAccounts()->withdraw(
    'SOURCE_BANK_ID',
    array(
        'account_id' => 'PAYPAY_ACCOUNT_ID',
        'amount'     => 100
    )
);

// Withdraw to Bank Account

// Authorize bank account to be used as a funding source
$authority = PromisePay::DirectDebitAuthority()->create(
    array(
        'account_id' => 'SOURCE_BANK_ID',
        'amount'     => 100
    )
);

$withdrawal = PromisePay::WalletAccounts()->withdraw(
    'SOURCE_BANK_ID',
    array(
        'account_id' => 'TARGET_BANK_ID',
        'amount'     => 100
    )
);

Deposit Funds

// Authorize bank account to be used as a funding source
$authority = PromisePay::DirectDebitAuthority()->create(
    array(
        'account_id' => 'SOURCE_BANK_ID',
        'amount'     => 100
    )
);

$deposit = PromisePay::WalletAccounts()->deposit(
    'TARGET_WALLET_ID',
    array(
        'account_id' => 'SOURCE_BANK_ID',
        'amount'     => 100
    )
);

Show Wallet Account User

$walletUser = PromisePay::WalletAccounts()->getUser('WALLET_ID');

Card Accounts

Create a card account

$account = PromisePay::CardAccount()->create(array(
   'user_id'      => 'USER_ID',
   'full_name'    => 'Bobby Buyer',
   'number'       => '4111111111111111',
   "expiry_month" => '06',
   "expiry_year"  => '2020',
   "cvv"          => '123'
));

Get a card account

$account = PromisePay::CardAccount()->get('CARD_ACCOUNT_ID');

Delete a card account

$account = PromisePay::CardAccount()->delete('CARD_ACCOUNT_ID');

Get a card account's users

$user = PromisePay::CardAccount()->getUser('CARD_ACCOUNT_ID');

Bank Accounts

Create a bank account

$account = PromisePay::BankAccount()->create(array(
    "user_id"        => 'USER_ID',
    "active"         => 'true',
    "bank_name"      => 'bank for test',
    "account_name"   => 'test acc',
    "routing_number" => '12344455512',
    "account_number" => '123334242134',
    "account_type"   => 'savings',
    "holder_type"    => 'personal',
    "country"        => 'USA',
));

Get a bank account

$account = PromisePay::BankAccount()->get('BANK_ACCOUNT_ID');

Delete a bank account

$account = PromisePay::BankAccount()->delete('BANK_ACCOUNT_ID');

Get a bank account's users

$user = PromisePay::BankAccount()->getUser('BANK_ACCOUNT_ID');

Validate Routing Number

$validateRoutingNumber = PromisePay::BankAccount()->validateRoutingNumber(
    'ROUTING_NUMBER'
);

PayPal Accounts

Create a PayPal account

$account = PromisePay::PayPalAccount()->create(array(
    'user_id'      => 'USER_ID',
    'paypal_email' => 'test@paypalname.com'
));

Get a PayPal account

$account = PromisePay::PayPalAccount()->get('PAYPAL_ACCOUNT_ID');

Delete a PayPal account

$account = PromisePay::PayPalAccount()->delete('PAYPAL_ACCOUNT_ID');

Get a PayPal account's users

$user = PromisePay::PayPalAccount()->getUser('PAYPAL_ACCOUNT_ID');

Batch Transactions

List Batch Transactions

$batches = PromisePay::BatchTransactions()->listTransactions();

Show Batch Transaction

$batch = PromisePay::BatchTransactions()->showTransaction(
    'BATCH_TRANSACTION_ID'
);

Charges

Create Charge

$createCharge = PromisePay::Charges()->create(
    array
    (
        'account_id' => 'CARD_OR_BANK_ACCOUNT_ID',
        'amount' => 100,
        'email' => 'charged.user@email.com',
        'zip' => 90210,
        'country' => 'AUS',
        'device_id' => 'DEVICE_ID',
        'ip_address' => '49.229.186.182'
    )
);

List Charges

$getList = PromisePay::Charges()->getList();

Show Charge

$charge = PromisePay::Charges()->show('CHARGE_ID');

Show Charge Buyer

$buyer = PromisePay::Charges()->showBuyer('CHARGE_ID');

Show Charge Status

$status = PromisePay::Charges()->showStatus('CHARGE_ID');

Marketplaces

Show Marketplace

$marketplaces = PromisePay::Marketplaces()->show();

Token Auth

Generate Card Token

$cardToken = PromisePay::Token()->generateCardToken(
    array
    (
        'token_type' => 'card',
        'user_id' => 'USER_ID'
    )
);

Direct Debit Authority

Create Direct Debit Authority

$directDebitAuthority = PromisePay::DirectDebitAuthority()->create(
    array
    (
        'account_id' => 'ACCOUNT_ID',
        'amount'     => 100
    )
);

List Direct Debit Authority

$getList = PromisePay::DirectDebitAuthority()->getList(
    array
    (
        'account_id' => 'BANK_ACCOUNT_ID'
    )
);

Show Direct Debit Authority

$directDebitAuthority = PromisePay::DirectDebitAuthority()->show(
    'DIRECT_DEBIT_AUTHORITY_ID'
);

Delete Direct Debit Authority

$deleteDirectDebitAuthority = PromisePay::DirectDebitAuthority()->delete(
    'DIRECT_DEBIT_AUTHORITY_ID'
);

Companies

Create a company

$company = PromisePay::Company()->create(array(
    'user_id'    => 'USER_ID',
    'legal_name' => 'Test edit company',
    'name'       => 'test company name edit',
    'country'    => 'AUS'
));

Get a company

$company = PromisePay::Company()->get('COMPANY_ID');

Get a list of companies

$companys = PromisePay::Company()->getList(array(
	'limit' => 20,
	'offset' => 0
));

Update a company

$company = PromisePay::Company()->update('COMPANY_ID', array(
    'id' => "e466dfb4-f05c-4c7f-92a3-09a0a28c7af5",
    'user_id' => "1",
    'name' => "Acme Co",
    'legal_name' => "Acme Co Pty Ltd",
    'tax_number' => "1231231",
    'charge_tax' => true,
    'address_line1' => "123 Test St",
    'address_line2' => "",
    'city' => "Melbourne",
    'state' => "VIC",
    'zip' => "3000",
    'country' => "AUS"
));

Fees

Get a list of fees

$fees = PromisePay::Fee()->getList(array(
	'limit' => 20,
	'offset' => 0
));

Get a fee

$fee = PromisePay::Fee()->get('FEE_ID');

Create a fee

$fee = PromisePay::Fee()->create(array(
    'amount'      => 1000,
    'name'        => 'fee test',
    'fee_type_id' => '1',
    'cap'         => '1',
    'max'         => '3',
    'min'         => '2',
    'to'          => 'buyer'
));

Transactions

Get a list of transactions

$transactions = PromisePay::Transaction()->getList(array(
	'limit' => 20,
	'offset' => 0
));

Get a transaction

$transaction = PromisePay::Transaction()->get('TRANSACTION_ID');

Get a transaction's user

$user = PromisePay::Transaction()->getUser('TRANSACTION_ID');

Get a transaction's fee

$fee = PromisePay::Transaction()->getFee('TRANSACTION_ID');

Show Transaction Wallet Account

$walletAccount = PromisePay::Transaction()->getWalletAccount(
    'TRANSACTION_ID'
);

Show Transaction Card Account

$cardAccount = PromisePay::Transaction()->getCardAccount(
    'TRANSACTION_ID'
);

Addresses

Show Address

$address = PromisePay::Address()->get('ADDRESS_ID');

Tools

Health check

$healthStatus = PromisePay::Tools()->getHealth();

Configurations

Create Configuration

$configuration = PromisePay::Configurations()->create(array(
    'name' => 'partial_refunds',
    'enabled' => true
));

Show Configuration

$configuration = PromisePay::Configurations()->get('CONFIGURATION_ID');

List Configurations

$configurations = PromisePay::Configurations()->getList();

Update Configuration

$configuration = PromisePay::Configurations()->update(array(
    'id' => 'CONFIGURATION_ID',
    'max' => 12345,
    'name' => 'partial_refunds',
    'enabled' => true
));

Delete Configuration

PromisePay::Configurations()->delete('CONFIGURATION_ID');

Payment Restrictions

List Payment Restrictions

$list = PromisePay::PaymentRestrictions()->getList();

Show Payment Restriction

$paymentRestriction = PromisePay::PaymentRestrictions()->get('PAYMENT_RESTRICTION_ID');

Callbacks

Create Callback

$callback = PromisePay::Callbacks()->create(array(
    'description' => 'Users Callback',
    'url' => 'https://domain.tld/your/post/endpoint',
    'object_type' => 'users',
    'enabled' => true
));

List Callbacks

$getList = PromisePay::Callbacks()->getList();

Show Callback

$getCallback = PromisePay::Callbacks()->get('f92d4ca1-4ee5-43f3-9e34-ca5f759c5e76');

Update Callback

$update = PromisePay::Callbacks()->update('f92d4ca1-4ee5-43f3-9e34-ca5f759c5e76', array(
    'description' => 'Users Callback',
    'url' => 'https://domain.tld/your/post/endpoint',
    'object_type' => 'users',
    'enabled' => false
));

Delete Callback

$delete = PromisePay::Callbacks()->delete('f92d4ca1-4ee5-43f3-9e34-ca5f759c5e76');

List Callback Responses

$callbackResponsesList = PromisePay::Callbacks()->getListResponses('f92d4ca1-4ee5-43f3-9e34-ca5f759c5e76');

Show Callback Response

$callbackResponse = PromisePay::Callbacks()->getResponse(
    'f92d4ca1-4ee5-43f3-9e34-ca5f759c5e76', // callback ID
    '4476b384-fa48-4473-98ec-8fcdda4a1e84' // response ID
);

Async and Wrappers

Async

Asynchronous execution provides a significant speed improvement, as compared to synchronous execution.

PromisePay::AsyncClient(
    function() {
        PromisePay::Token()->generateCardToken('CARD_TOKEN_ID');
    },
    function() {
        PromisePay::Transaction()->get('TRANSACTION_ID');
    },
    function() {
        PromisePay::Transaction()->getUser('USER_ID');
    },
    function() {
        PromisePay::BatchTransactions()->listTransactions();
    }
)->done(
    $cardToken,
    $transaction,
    $transactionUser,
    $batchTransactions
);

Response variables are placed inside done() method; they can be used both as arrays and objects, but using them as objects provides finer grained control. For example, the following will return equivalent data: $cardToken['user_id'] and $cardToken->getJson('user_id').

Response variables contain the following methods/getters:

getJson() -> full response JSON
getMeta() -> meta array extracted from response JSON, if present
getLinks() -> links array extracted from response JSON, if present
getDebug() -> response headers

Wrappers

Two wrappers are available: PromisePay::getAllResults() and PromisePay::getAllResultsAsync(). They can be used to get all results from sets of result pages, instead of up to 200 per request. For example, they can be used to fetch all batch transactions at once. Note that these requests may take some time depending on amount requested. If getting all results is mandatory, no matter how big the size, use the synchronous version. For a faster version, use async version, but not all requests are guaranteed to be returned. Generally, asynchronous execution is fine for up to 20 pages, each containing up to 200 results, yielding 4000 results within a few seconds.

Synchronous execution

$batchedTransactionsList = PromisePay::getAllResults(function($limit, $offset) {
    PromisePay::BatchTransactions()->listTransactions(
        array(
            'limit' => $limit,
            'offset' => $offset
        )
    );
});

Asynchronous execution

$batchedTransactionsList = PromisePay::getAllResultsAsync(function($limit, $offset) {
    PromisePay::BatchTransactions()->listTransactions(
        array(
            'limit' => $limit,
            'offset' => $offset
        )
    );
});

Contributing

1. Fork it ( https://github.com/PromisePay/promisepay-php/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request

ninoskopac/promisepay-php 适用场景与选型建议

ninoskopac/promisepay-php 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 17 次下载、GitHub Stars 达 0，最近一次更新时间为 2016 年 06 月 09 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「api」「payments」「marketplace」「escrow」「promisepay」「marketplace payments」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 ninoskopac/promisepay-php 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 ninoskopac/promisepay-php 我们能提供哪些服务？

定制开发 / 二次开发

基于 ninoskopac/promisepay-php 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 ninoskopac/promisepay-php 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

basketin/laravel-paymob 1

Dealing with payments through the Egyptian payment gateway PayMob

ideatic/payments 5

Librería para la gestión sencilla de pagos mediante TPV Redsys y Paypal

theodorejb/phaster 6

A PSR-7 compatible library for making CRUD API endpoints

pdchaudhary/lokalise-pimcore 7

Automatically translate and review your content via Lokalise.

logicssoftware/braspag-php-sdk 11

SDK de integração com a API de pagamentos da Braspag

maikealame/moip-sdk-php 0

Cliente em PHP para integração server-side com APIs Moip v2

ninoskopac/promisepay-php

包简介

关键字：