paypal-rs/README.md

91 lines
2.6 KiB
Markdown

# paypal-rs
[![Version](https://img.shields.io/crates/v/paypal-rs)](https://crates.io/crates/paypal-rs)
[![Downloads](https://img.shields.io/crates/d/paypal-rs)](https://crates.io/crates/paypal-rs)
[![License](https://img.shields.io/crates/l/paypal-rs)](https://crates.io/crates/paypal-rs)
![Rust](https://github.com/edg-l/paypal-rs/workflows/Rust/badge.svg)
[![Docs](https://docs.rs/paypal-rs/badge.svg)](https://docs.rs/paypal-rs)
A rust library that wraps the [paypal api](https://developer.paypal.com/docs/api) asynchronously in a strongly typed manner.
If there is a missing endpoint that you need, you may try to implement the [Endpoint](endpoint::Endpoint) and pass it to [Client::execute](client::Client::execute)
Currently in early development.
### Example
```rust
use paypal_rs::{
Client,
api::orders::*,
data::orders::*,
data::common::Currency,
};
#[tokio::main]
async fn main() {
dotenv::dotenv().ok();
let clientid = std::env::var("PAYPAL_CLIENTID").unwrap();
let secret = std::env::var("PAYPAL_SECRET").unwrap();
let mut client = Client::new(clientid, secret, true);
client.get_access_token().await.unwrap();
let order = OrderPayloadBuilder::default()
.intent(Intent::Authorize)
.purchase_units(vec![PurchaseUnit::new(Amount::new(Currency::EUR, "10.0"))])
.build().unwrap();
let create_order = CreateOrder::new(order);
let _order_created = client
.execute(&create_order).await.unwrap();
}
```
### Testing
You need the enviroment variables PAYPAL_CLIENTID and PAYPAL_SECRET to be set.
`cargo test`
### Roadmap
- [x] Orders API - 0.1.0
- - [x] Create order
- - [x] Update order
- - [x] Show order details
- - [x] Authorize payment for order
- - [x] Capture payment for order
- [x] Invoicing API - 0.2.0
- - [x] Generate Invoice number
- - [x] Create Draft Invoice
- - [x] Show Invoice Details (Get Invoice)
- - [x] List Invoices
- - [x] Delete Invoice
- - [x] Update Invoice
- - [x] Cancel Invoice
- - [x] Send Invoice
- - [ ] Send Invoice Reminder
- - [ ] List Templates
- - [ ] Create Template
- - [ ] Delete Template
- - [ ] Fully Update Template
- - [ ] Show Template Template
- [ ] Payments API - 0.3.0
- [ ] Tracking API - 0.4.0
- [ ] Subscriptions API - 0.5.0
- [ ] Identity API - 0.6.0
- [ ] Disputes API - 0.7.0
- [ ] Catalog Products API - 0.8.0
- [ ] Partner Referrals API - 0.9.0
- [ ] Payouts API - 0.10.0
- [ ] Transaction Search API - 0.11.0
- [ ] Referenced Payouts API - 0.12.0
- [ ] Vault API - 0.13.0
- [ ] Webhooks Management API - 0.14.0
- [ ] Payment Experience Web Profiles API - 1.0.0
License: MIT OR Apache-2.0