paymentcorner/payment-corner-sdk

此包的最新版本（dev-master）没有可用的许可证信息。

Payment Corner API

维护者

详细信息

github.com/PaymentCorner/SDK

源代码

问题

安装: 0

依赖项: 0

建议者: 0

安全性: 0

星星: 0

观察者: 1

分支: 0

开放问题: 0

dev-master 2019-02-01 08:55 UTC

Requires

Unknown License 9294d48c62188acd56dcd5522a7a743f0f04b690

This package is not auto-updated.

Last update: 2024-09-22 11:19:36 UTC

README

alt text <>

Payment Corner PHP SDK

Version Build Status

介绍

Payment Corner (Switzerland) Ltd 是一个开放的外汇平台，允许客户将需要外汇功能的产品集成到他们的系统、应用程序和工作流程中。

客户可以通过PHP SDK，使用从用户仪表板获取的客户ID、电子邮件和密码连接到Payment Corner平台。

支持货币

我们的外汇平台目前支持以下28种货币

安装

使用以下命令安装包

composer require paymentcorner/payment-corner-sdk

建议使用Composer安装Payment Corner SDK。Composer是PHP的依赖管理工具，允许您声明项目需要的依赖并安装到项目中。

{
   "require": {
      "paymentcorner/payment-corner-sdk": "dev-master"
   }
}

或者，您可以在项目的现有composer.json文件中将Payment Corner SDK指定为依赖项

<?php

require __DIR__.'/vendor/autoload.php';

安装后，您需要要求Composer的自动加载器

您可以在getcomposer.org上了解更多有关如何安装Composer、配置自动加载以及其他定义依赖项的最佳实践。

使用方法

此包需要配置您的账户电子邮件、密码和客户端ID，客户端ID可以从Payment Corner仪表板获取。

<?php
require __DIR__.'/vendor/autoload.php';

try{
    $paymentCorner = new PaymentCorner('user@mail.com','password','client_id',devMode);
}catch (PaymentCornerExceptions $exception){
    echo $exception->getMessage();
}

启用生产环境

默认情况下，PaymentCorner初始化为沙盒环境。在初始化SDK时设置devMode为true以启用生产环境，设置为false以启用沙盒环境。

外汇交易

进行外汇交易（买卖双方），获取您的报价并确认外汇交易。

必需参数

可选参数

使用方法

require __DIR__.'/vendor/autoload.php';

try{
    $paymentCorner = new PaymentCorner('user@domain.com','password','xxxx-xxxx-xxxxx-xxxxx',true);
    $transaction = new Transactions();
       $transaction->setCurrencyToBuy('USD');
       $transaction->setCurrencyToSell('GBP');
       $transaction->setAmount(150);
       $transaction->setSideOfFxTx('buy');
       $transaction->setFxTxGtc(true);
    $paymentCorner->fxTransaction($transaction);
}catch (PaymentCornerExceptions $exception){
    echo $exception->getMessage();

}

结果

{ 
    path: '1ca9c450-0c48-472c-9fc1-6ae0544b3f2c',
    date_of_settlement: '2019-01-28T14:30:00+00:00',
    fx_tx_date: '2019-01-28T00:00:00+00:00',
    creator_contact_id: '08b45825-3ded-481d-ac93-9c22b908e10a',
    account_id: '0f1c61be-64ca-4c93-bdd3-1b384370378e',
    currency_pair: 'EURUSD',
    currency_to_buy: 'EUR',
    currency_to_sell: 'USD',
    amount_to_buy: '126.51',
    amount_to_sell: '150.00',
    side_of_fx_tx: 'sell',
    market_rate: '1.1857',
    client_net_rate: '1.1857',
    fx_tx_unique_id: null,
    fx_tx_creation_date: '2019-01-28T08:49:10+00:00',
    fx_tx_update_date: '2019-01-28T08:49:10+00:00',
    mid_market_rate: '1.1856',
    fx_tx_status: 'Funds_to_receive',
    ref: '20190128-ZVDHJZ-EbJF8960'
  }

外汇交易状态（fx_tx_status）

检索外汇交易

根据一个或多个参数检索一个或多个外汇交易。

可选参数

使用方法

<?php

require __DIR__.'/vendor/autoload.php';

try{
    $paymentCorner = new PaymentCorner('user@domain.com','password','xxxx-xxxx-xxxxx-xxxxx',true);
   $transaction = new Transactions();
   $paymentCorner->retrieveFxTransaction($transaction);
}catch (PaymentCornerExceptions $exception){
   echo $exception->getMessage();

}

结果

{
         "conversions": [
         {
             "path": "832d46cd-d0ec-4717-9435-cc34d587dc95",
             "date_of_settlement": "2018-11-28T16:30:00+00:00",
             "date_of_conversion": "2018-11-28T00:00:00+00:00",
             "creator_contact_id": "f72a98bf-2d4d-421f-b5c1-425d19077002",
             "account_id": "0f1c61be-64ca-4c93-bdd3-1b384370378e",
             "currency_pair": "GBPUSD",
             "currency_to_buy": "USD",
             "currency_to_sell": "GBP",
             "amount_to_buy": "1000.00",
             "amount_to_sell": "710.28",
             "side_of_fx_tx": "buy",
             "client_rate": "1.4079",
             "fx_tx_unique_id": null,
             "fx_tx_creation_date": "2018-11-26T09:00:48+00:00",
             "fx_tx_update_date": "2018-11-28T06:31:04+00:00",
             "mid_market_rate": "1.4080",
             "fx_tx_status": "FX_deal_settled",
             "ref": "20181126-KSBMRW-IWwN2584"
         }
         ],
         "pagination": {
             "tot_nbr_entries": 2,
             "tot_nbr_pages": 1,
             "current_page": 1,
             "result_per_page": 25,
             "goto_previous_page": -1,
             "goto_next_page": 2,
             "sort_order": "created_at",
             "sort_asc_to_desc": "asc"
         }
     }

检索外汇交易记录

根据唯一的外汇交易ID检索单个外汇交易。

必需参数

使用方法

<?php

require __DIR__.'/vendor/autoload.php';

try{
  $paymentCorner = new PaymentCorner('user@domain.com','password','xxxx-xxxx-xxxxx-xxxxx',true);
   $transaction = new Transactions();
   $transaction->setPath("832d46cd-d0ec-4717-9435-cc34d587dc95");
   $paymentCorner->retrieveFxTransactionRecord($transaction);
}catch (PaymentCornerExceptions $exception){
   echo $exception->getMessage();
}

结果

{
          "path": "832d46cd-d0ec-4717-9435-cc34d587dc95",
          "date_of_settlement": "2018-11-28T16:30:00+00:00",
          "date_of_conversion": "2018-11-28T00:00:00+00:00",
          "creator_contact_id": "f72a98bf-2d4d-421f-b5c1-425d19077002",
          "account_id": "0f1c61be-64ca-4c93-bdd3-1b384370378e",
          "currency_pair": "GBPUSD",
          "currency_to_buy": "USD",
          "currency_to_sell": "GBP",
          "amount_to_buy": "1000.00",
          "amount_to_sell": "710.28",
          "side_of_fx_tx": "buy",
          "client_rate": "1.4079",
          "fx_tx_unique_id": null,
          "fx_tx_creation_date": "2018-11-26T09:00:48+00:00",
          "fx_tx_update_date": "2018-11-28T06:31:04+00:00",
          "mid_market_rate": "1.4080",
          "fx_tx_status": "FX_deal_settled",
          "ref": "20181126-KSBMRW-QgGW6160"
      }

更改外汇转换值日期

使用唯一的外汇交易路径更改外汇转换值日期。

必需参数

使用方法

<?php

require __DIR__.'/vendor/autoload.php';

try{
   $paymentCorner = new PaymentCorner('user@domain.com','password','xxxx-xxxx-xxxxx-xxxxx',true);
   $transaction = new Transactions();
   $transaction->setPath("832d46cd-d0ec-4717-9435-cc34d587dc95");
   $transaction->newDateFxTx("2019-01-14T14:30:00+00:00");
   $paymentCorner->changeFxConversionDeliveryDateQuotation($transaction);
}catch (PaymentCornerExceptions $exception){
   echo $exception->getMessage();
}

结果

 {
         "path": "e5cce1bf-af7e-4633-b6ae-bae4b8bcaf36",
         "amount": "2.00",
         "currency": "USD",
         "new_conversion_date": "2018-12-20T00:00:00+00:00",
         "new_date_fx_tx": "2018-12-20T16:30:00+00:00",
         "old_conversion_date": "2018-12-11T00:00:00+00:00",
         "old_settlement_date": "2018-12-11T16:30:00+00:00",
         "event_date_time": "2018-12-11T06:37:12+00:00"
     }

更改外汇转换交付日期报价

允许您在外汇交易结算日期更改时获取新的汇率。

必需参数

使用方法

<?php

require __DIR__.'/vendor/autoload.php';

try {
 $paymentCorner = new PaymentCorner('user@domain.com','password','xxxx-xxxx-xxxxx-xxxxx',true);
   $transaction = new Transactions();
   $transaction->setPath("832d46cd-d0ec-4717-9435-cc34d587dc95");
   $transaction->newDateFxTx("2019-01-14T14:30:00+00:00");
   $paymentCorner->changeFxConversionDeliveryDateQuotation($transaction);
}catch (PaymentCornerExceptions $exception){
   echo $exception->getMessage();
}

结果

{
         "path": "e5cce1bf-af7e-4633-b6ae-bae4b8bcaf36",
         "amount": "2.00",
         "currency": "USD",
         "new_conversion_date": "2018-12-20T00:00:00+00:00",
         "new_date_fx_tx": "2018-12-20T16:30:00+00:00",
         "old_conversion_date": "2018-12-11T00:00:00+00:00",
         "old_settlement_date": "2018-12-11T16:30:00+00:00",
         "event_date_time": "2018-12-11T06:37:12+00:00"
     }

外汇市场汇率加价

获取任何货币对的包含您的加价的外汇市场汇率。

必需参数

使用方法

<?php

require __DIR__.'/vendor/autoload.php';

try {
 $paymentCorner = new PaymentCorner('user@domain.com','password','xxxx-xxxx-xxxxx-xxxxx',true);
     $rates = new Rates();
     $rates->setCurrencyToBuy('EUR');
     $rates->setCurrencyToSell('EUR');
     $rates->setSideOfFxTx('buy');
     $rates->setAmount('1000');
     $paymentCorner->fxMarketRatewMarkUp($rates);
 } catch (PaymentCornerExceptions $exception){
     echo $exception->getMessage();
 }

结果

{
    "settlement_cut_off_time": "2018-12-13T16:30:00Z",
    "currency_pair": "GBPUSD",
    "currency_to_buy": "USD",
    "currency_to_sell": "GBP",
    "amount_to_buy": "10.00",
    "amount_to_sell": "7.10",
    "side_of_fx_tx": "buy",
    "client_rate": "1.4079",
    "mid_market_rate": "1.4080"
}

外汇市场汇率

获取任何货币对的银行间汇率。

必需参数

使用方法

<?php

require __DIR__.'/vendor/autoload.php';

try {
 $paymentCorner = new PaymentCorner('user@domain.com','password','xxxx-xxxx-xxxxx-xxxxx',true);   
    $rates = new Rates();
    $rates->setCurrencyPair('GBPUSD');
    $paymentCorner->fxMarketRate($rates);
} catch (PaymentCornerExceptions $exception){

    echo $exception->getMessage();
}

结果

{
    "rates": {
        "GBPUSD": [
            "1.407700",
            "1.408300"
        ]
    },
    "unavailable": []
}