# binance-pay-rs

Unofficial Rust Library for the [Binance Pay API](https://developers.binance.com/docs/binance-pay/introduction)

[![Crates.io][crates-badge]][crates-url]
[![Build Status][actions-badge]][actions-url]
[![Discord chat][discord-badge]][discord-url]


[actions-badge]: https://img.shields.io/github/workflow/status/akarsh1995/binance-pay-rs/Continuous%20integration?style=for-the-badge&logo=githubactions&logoColor=white
[actions-url]: https://github.com/akarsh1995/binance-pay-rs/actions

[discord-badge]: https://img.shields.io/discord/974880467801235546?style=for-the-badge&logo=discord&logoColor=white
[discord-url]: https://discord.gg/Y5yxfQUC

[crates-badge]: https://img.shields.io/crates/v/binance-pay-rs?style=for-the-badge&logo=rust
[crates-url]: https://crates.io/crates/binance-pay-rs

> :warning: The APIs are expected to work fine, still, **You might encounter bugs. Please use at your own risk.**   
The current version implements all the API endpoints as documented in the Binance pay [developer documentation](https://developers.binance.com/docs/binance-pay/api-order-create-v2).

## Quickstart

**Make sure the following env variables are set:**
> To generate the api key visit [Developers](https://merchant.binance.com/en/dashboard/developers)
  - `BINANCE_PAY_API_KEY`
  - `BINANCE_PAY_API_SECRET`
  

**In your `Cargo.toml` file**
```toml
[dependencies]
binance-pay-rs = "^0"
tokio = { version = "1.18.0", features = ["rt-multi-thread", "macros"] }
```

**In your `main.rs` file**

```rust
use bpay::api::order::create::{
    Currency, Env, Goods, GoodsCategory, GoodsType, Request as OrderRequest, TerminalType,
};
use bpay::api::Binance;
use bpay::client::Client;
use bpay::errors::Result;
use bpay::utils::create_nonce;
use tokio;

#[tokio::main]
async fn main() -> Result<()> {
    let order = OrderRequest {
        env: Env {
            terminal_type: TerminalType::Web,
        },
        merchant_trade_no: create_nonce(10),
        order_amount: 10.0,
        currency: Currency::USDT,
        goods: Goods {
            goods_type: GoodsType::VirtualGoods,
            goods_category: GoodsCategory::Electronics,
            reference_goods_id: "sku1234".into(),
            goods_name: "Laptop".into(),
            goods_detail: None,
        },
    };

    let client = Client::from_env();
    let create_order_result = order.create(&client).await?;
    println!(
        "This url can be sent across to complete the payment procedure: {}",
        create_order_result.universal_url
    );
    Ok(())
}
```

### To run an example: 
```sh
cargo run --example notification_axum_server
```

## Contributing:


Simply create a pull request. Properly documented code and tests.  

To run the tests:

```sh
cargo t
```