91 lines
2.6 KiB
Markdown
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() {
|
|
dotenvy::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
|