Payu REST API

Install

bash cargo add pay_u

Usage

```rust async fn usage() { let clientid = ClientId::new(std::env::var("PAYUCLIENTID").unwrap()); let clientsecret = ClientSecret::new(std::env::var("PAYUCLIENTSECRET").unwrap()); let merchantid = std::env::var("PAYUCLIENTMERCHANTID").unwrap().parse::().map(MerchantPosId::from).unwrap(); let mut client = Client::new(clientid, clientsecret, merchant_id); client.authorize().await.expect("Invalid credentials");

let _res = client.create_order(
    OrderCreateRequest::build(
        Buyer::new("john.doe@example.com", "654111654", "John", "Doe", "pl"),
        "127.0.0.1",
        "PLN",
        "Some description"
    )
        .expect("All required fields must be valid")
        // Endpoint which will be requested by PayU with payment status update
        .with_notify_url("https://your.eshop.com/notify")
        // payment description (MANDATORY)
        .with_description("RTV market")
        // add list of products
        .with_products(
            [
                Product::new("Wireless Mouse for Laptop", 15000, 1),
                Product::new("HDMI cable", 6000, 1),
            ]
                .into_iter(),
        )
        // add additional product
        .with_product(Product::new("HDMI cable", 6000, 1)),
)
    .await;

// partial refund
let _res = client
    .refund(
        OrderId::new("H9LL64F37H160126GUEST000P01"),
        RefundRequest::new("Refund", Some(1000)),
    )
    .await;
// Full refund
let _res = client
    .refund(
        OrderId::new("H9LL64F37H160126GUEST000P01"),
        RefundRequest::new("Refund", None),
    )
    .await;

// Order details
let _res = client.order_details(OrderId::new("H9LL64F37H160126GUEST000P01")).await;

// Transactions
let _res = client.order_transactions(OrderId::new("H9LL64F37H160126GUEST000P01")).await;

} ```

Actix integration

```rust use actix_web::{, web::};

[post("/checkout")]

async fn checkout(session: Data, db: Data, payu: Data>>) -> HttpResponse { let userid = session.userrequired()?; let payu = payu.intoinner(); let shoppingcart = db.send(LoadShoppingCart { userid }).await??; let shoppingcartid = shoppingcart.id; let createorderreq: payu::OrderCreateRequest = shoppingcart.into(); let payu::res::CreateOrder { redirecturi, orderid, .. } = payu.createorder(createorderreq).await?; db.send(database::CreateOrder { shoppingcartid, orderid }).await??; HttpResponse::SeeOther().appendheader((actixweb::http::header::LOCATION, redirecturi)).body("") }

[post("/payu/{ownorder_id}/notify")]

async fn handlenotification(path: Path, Json(notify): Json) -> HttpResponse { let status = notify.status(); let orderid = path.intoinner(); match handleupdate(orderid, status, notify) { Ok() => (), Err(e) => { // ALWAYS SEND OK! log::error!("{e:?}"); } }; HttpResponse::Ok().body("") } ```

Releases

0.1.7 - Added credit and more create order request options like additional description, visible description.

Bugs

Please report bugs here: https://todo.sr.ht/~tsumanu/payu-rs