intram-sdk/php

帮助企业和个人安全地通过移动货币、信用卡和银行账户接收付款。

维护者

详细信息

github.com/intram-sdk/php

来源

问题

安装次数: 22

依赖项: 0

建议者: 0

安全性: 0

星标: 0

关注者: 1

分支: 0

开放问题: 0

dev-master 2021-03-16 20:02 UTC

Requires

MIT 0e69a39cee874b6afb01e693e63d4d5d54e58ea2

  • Suntech Devs <suntechdevs.woop@gmail.com>

This package is not auto-updated.

Last update: 2024-09-25 12:35:50 UTC

README

用于 PHP 的 INTRAM (intram.com) 库。

基于 INTRAM HTTP API (beta) 构建。

生成您的 API 密钥

通过 composer 安装

composer require intram-sdk/php

API 配置

配置 intram API 密钥。

$paycfa = new \intram\PayCfa\PayCfa(
            "5b06f06a0aad7d0163c414926b635ee9cdf41438de0f09d70a4acf153083b7ed375a691e3513b42544530469e1ff8657b34508dc61927048444dd6dc9ccbb87f",
            "pk_9c0410014969f276e8b3685fec7b1b2ab41fc760db2976c75e32ec0fdc3b7d5575a7087f9aeb4d8a29a949ac4cac11363b39ff6a6d9dc3bc6ce0f328c62c3c58",
            "sk_08bd75f9468b484d8a9f24daddff4638d6513fdcf3ff4dd533e72ce55c22eac3207c12af49400ecddb1969ad3db152b0c338c0050c4540f9d0cb8c3cd3cb8c26",
            "marchand_id",
            true)

登录到您的 Intram 账户，点击“开发者”，然后点击此级别的“API”，获取 API 密钥，并将其作为参数传递给控制器。通过按顺序输入 PUBLIC_KEY，PRIVATE_KEY，INTRAM_SECRET，INTRAM_MERCHANT_KEY，MODE 来初始化 Intram PayCfa。模式：true 用于实时模式，false 用于测试模式。

##配置您的服务/企业信息

定义商店名称

(必填)

$paycfa->setNameStore("Suntech Store");
定义商店标志的 URL
$paycfa->setLogoUrlStore("https://www.suntechshop/logo.png");
配置商店网站
$paycfa->setWebSiteUrlStore("https://www.suntechshop");
配置电话号码
$paycfa->setPhoneStore("97000000");
配置邮政地址
$paycfa->setPostalAdressStore("BP 35");

##创建支付交易 为了让用户能够在您的商店进行支付，您必须创建交易，然后发送付款 URL 或二维码供扫描。为此

添加发票项目

添加购买的不同产品（必填）

$paycfa->setItems([
            ['name'=>"T-shirt",'qte'=>"2",'price'=>"500",'totalamount'=>"1000"],
            ['name'=>"trouser",'qte'=>"1",'price'=>"12500",'totalamount'=>"12500"],
        ]);
配置增值税金额

增值税（可选）

payfa->setTva([["name" => "VAT (18%)", "amount" => 1000],["name" => " other VAT", "amount" => 500]]);
添加自定义数据

(可选)

$paycfa->setCustomData([['CartID',"32393"],['PERIOD',"TABASKI"]]);
定义总金额

订单总额（必填）

$paycfa->setAmount(13600);
定义货币

支付货币（必填）

$paycfa->setCurrency("XOF");
描述

操作描述（必填）

$paycfa->setDescription("Pretty and suitable for your waterfall");
在支付门户上使用的模板

(必填)

$paycfa->setTemplate("default");
定义商店重定向 URL

(可选)

$paycfa->setRedirectionUrl("https://www.suntechshop/redirection-url");
定义商店返回 URL

(可选)

$paycfa->setReturnUrl("https://www.suntechshop/return-url");
定义商店取消 URL

(可选)

$paycfa->setCancelUrl("https://www.suntechshop/cancel-url");
发起支付请求

(必填)

$response = json_decode($paycfa->setRequestPayment());
预期响应
{
              "status": "PENDING",
              "transaction_id": "5f2d7a96b97d9d3fea912c11",
              "receipt_url": "localhost:3000/payment/gate/5f2d7a96b97d9d3fea912c11",
              "total_amount": 1000,
              "message": "Transaction created successfully",
              "error": false
}
获取数据
$transaction_id = $response->transaction_id;
$status = $response->status;
$receipt_url = $response->receipt_url;
$total_amount = $response->total_amount;
$message = $response->message;
$error = $response->error;

##获取交易状态

将交易 ID 作为函数参数传递（必填）

$paycfa->getTransactionStatus(5f2d7a96b97d9d3fea912c11);
预期响应
{
  "error":false,
  "status":"PENDING",
  "transaction":{
    "_status":"PENDING",
    "_channels":[
    ],
    "_created_at":"2021-02-16T16:56:56.488Z",
    "_id":"602fd5463f1edd6264e4107c",
    "_env":"sandbox",
    "_type":"DEBIT",
    "marchand":{
      "_statut":true,
      "_principal":true,
      "_state_id":"5f31a47a38111e135ae7b7f3",
      "_valide":true,
      "customers":[
        "602e587a3f1edd6264e4107a"
      ],
      "_settingtransaction":[
      ],
      "_template":[
      ],
      "_env":"sandbox",
      "_created_at":"2021-02-16T11:44:58.649Z",
      "_id":"602bb0987b66df8e97a4ef9e",
      "_reason":null,
      "_usermeanspaiement":[
        "602e3380b937b529ebfbf23f",
        "602e36178fca9830534e5271"
      ],
      "_settingreversement":null,
      "wallet":"602bb0997b66df8e97a4ef9f",
      "_user_id":"601bbe97cc481829fa1237fd",
      "_web_site":"https:://speedcash.com",
      "_company":"SpeedCash",
      "_email":"speedcash@gmail.com",
      "_categorie_id":"60268a988835ed5bff34de89",
      "country":"6013d5f9c477f8777270787b",
      "__v":1
    },
    "_actions":{
      "cancel_url":"https://jshop.com/",
      "return_url":"https://jshop.com/",
      "callback_url":"https://jshop.com/"
    },
    "_store":{
      "name":"JShop",
      "postal_adress":"BP 35",
      "logo_url":"https://jshop.com/logo.png",
      "web_site_url":"https://jshop.com/logo.png",
      "phone":"97000000",
      "template":"default"
    },
    "_reference":"QW9PHIeVyL",
    "_amount":1000,
    "_country_code":"BJ",
    "_qrcode":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAHQAAAB0CAYAAABUmhYnAAAAAklEQVR4AewaftIAAAK2SURBVO3BQW7sWAwEwSxC979yjpdcPUCQur/NYUT8wRqjWKMUa5RijVKsUYo1SrFGKdYoxRqlWKMUa5RijVKsUYo1SrFGKdYoFw8l4ZtUTpLQqXRJ6FROkvBNKk8Ua5RijVKsUS5epvKmJJwkoVM5UXlC5U1JeFOxRinWKMUa5eLDknCHyh0qJ0m4Q+WOJNyh8knFGqVYoxRrlIv/GZXJijVKsUYp1igXf1wSTlS6JJyo/GXFGqVYoxRrlIsPU/kklZMknKg8ofKbFGuUYo1SrFEuXpaEb0pCp3Ki0iWhUzlJwm9WrFGKNUqxRok/WGMUa5RijVKsUS4eSkKn0iWhU+mS0Kl0SehUTpLQqZwkoVO5IwmdykkSOpU3FWuUYo1SrFEufpkkdCpdEjqVTqVLwolKl4QTlU6lS0KncpKETuWJYo1SrFGKNcrFy5LQqXRJOFHpktCpdEn4piQ8odIl4U3FGqVYoxRrlPiDfygJncoTSehUuiScqHRJ6FTelIRO5YlijVKsUYo1SvzBA0k4UemS0Kl0SThR6ZLwhModSXhC5ZOKNUqxRinWKPEHf1gS7lD5piScqLypWKMUa5RijXLxUBK+SaVTOUnCSRLuUHlTEjqVJ4o1SrFGKdYoFy9TeVMS7khCp3Ki0iWhU3mTSpeENxVrlGKNUqxRLj4sCXeo3JGEJ5LwRBI6lX+pWKMUa5RijXLxx6l0SeiScKLSJeEOlS4JnUqXhE7lTcUapVijFGuUiz8uCW9S6ZLQqXRJuEOlS0Kn8kSxRinWKMUa5eLDVD5JpUvCHUk4UemS0KmcJOGbijVKsUYp1igXL0vCNyXhCZWTJHQqXRLuUOmS8KZijVKsUYo1SvzBGqNYoxRrlGKNUqxRijVKsUYp1ijFGqVYoxRrlGKNUqxRijVKsUYp1ij/AQf/C/ZESO1HAAAAAElFTkSuQmCC",
    "x_currency":"6013e6c0a948101dcda9acd9",
    "__v":0,
    "invoice":{
      "custom_datas":[
        [
          "CartID",
          "32393"
        ],
        [
          "PERIOD",
          "TABASKI"
        ]
      ],
      "_created_at":"2021-02-16T16:56:58.771Z",
      "_id":"602fd5473f1edd6264e4107d",
      "currency":"XOF",
      "items":[
        {
          "_id":"602fd5473f1edd6264e4107e",
          "name":"short",
          "price":500
        }
      ],
      "taxes":[
        {
          "_id":"602fd5473f1edd6264e4107f",
          "name":"VAT (18%)",
          "amount":1000
        },
        {
          "_id":"602fd5473f1edd6264e41080",
          "name":"other VAT",
          "amount":500
        }
      ],
      "amount":1000,
      "description":"At vero eos et accusam et justo duo dolores",
      "transaction":"602fd5463f1edd6264e4107c",
      "__v":0
    }
  },
  "message":"statut de la transaction"
}

正在运行测试

要运行测试，请设置 API 配置环境变量。一些测试需要互联网连接才能通过。

许可

MIT