#payment-gateway #fintech #payment #shurjopay #api-bindings #shurjomukhi

shurjopay-plugin

Rust插件,用于快速集成shurjopay API

2个版本

0.1.1 2023年1月1日
0.1.0 2023年1月1日

#801 in 编码

MIT许可证

44KB
697

alt text Shurjopay Rust Crate (插件)

Test Status Crate Book API API Minimum rustc version MIT licensed

官方shurjoPay Rust Crate (插件),供商家或服务提供商连接到由ShurjoMukhi Limited开发和维护的shurjoPay支付网关v2.1。

此插件包可用于任何Rust应用程序或框架(例如yew、rocket等)。它使开发者只需通过三次API调用即可轻松集成shurjoPay v2.1。

  1. makePayment:创建并发送支付请求
  2. verifyPayment:在shurjoPay上验证支付状态
  3. paymentStatus:检查支付详情和状态

此外,它还减少了您必须手动执行的大多数操作

  • 处理HTTP请求和请求错误
  • JSON序列化和反序列化
  • 结账期间的认证和支付验证

受众

本文档旨在为想要使用Python集成shurjoPay在线支付网关的商家和服务提供商的开发人员和技术人员。

如何使用此shurjoPay插件

要将shurjoPay支付网关集成到您的Rust项目中,请依次执行以下任务。

步骤1:Cargo.toml文件配置

[dependencies]
shurjopay-plugin = "0.1.1"

步骤2:将Crate导入到您的项目中

use shurjopay_plugin::Shurjopay::ShurjopayPlugin;

步骤3:创建ShurjopayPlugin的新实例

let mut sp_instance = ShurjopayPlugin::new();

步骤4:设置ShurjopayPlugin的配置

您可以通过两种方式配置ShurjopayPlugin

  • 选项1:使用.env文件配置插件
sp_instance.set_config_from_env_file();

以这种方式,您需要按以下方式配置.env文件。

请将.toml和.env文件放在同一目录下

# .env
SP_USERNAME="sp_sandbox"
SP_PASSWORD="pyyk97hu&6u6"
POST_DEFAULT_ADDRESS="https://sandbox.shurjopayment.com"
DEFAULT_RETURN_URL="https://sandbox.shurjopayment.com/response"
DEFAULT_CANCEL_URL="https://sandbox.shurjopayment.com/response"
  • 选项2:使用此函数配置插件
sp_instance.set_all_config(
        "sp_sandbox".to_string(),                                   // SP_USERNAME
        "pyyk97hu&6u6".to_string(),                                 // SP_PASSWORD
        "https://sandbox.shurjopayment.com".to_string(),            // POST_DEFAULT_ADDRESS
        "https://sandbox.shurjopayment.com/response".to_string(),   // DEFAULT_RETURN_URL
        "https://sandbox.shurjopayment.com/response".to_string(),   // DEFAULT_CANCEL_URL
        );

步骤5:要初始化支付,首先需要使用以下函数配置支付请求对象,并将其传递给make_payment_no_auto_redirect()函数

let payment_req_obj = sp_instance.make_payment_request_object(
    "786".to_string(),              // amount
    "abc123".to_string(),           // order_id
    "BDT".to_string(),              // currency
    "Mahmudul Islam".to_string(),   // customer_name
    "Dhaka".to_string(),            // customer_address
    "01800000000".to_string(),      // customer_phone
    "Dhaka".to_string(),            // customer_city
    "1203".to_string(),             // customer_post_code
    );
let checkout_url = sp_instance.make_payment(payment_req_obj); 

参考

  1. shurjoPay Rust Crate (插件) API文档 插件API文档
  2. Rust示例应用程序 展示了Rust crate的用法。
  3. 多种语言和框架下的示例应用程序和项目,展示了shurjopay的集成。
  4. shurjoPay Postman网站,通过沙盒系统说明了请求和响应流程。
  5. shurjopay插件在github的主页

许可

此代码遵循MIT开源许可

如需更多详细信息,请与shurjoPay团队联系

依赖项

~7–22MB
~297K SLoC