go-packages/paypal
1
0
Fork 1
mirror of https://github.com/plutov/paypal.git synced 2025-01-23 10:21:03 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

return examples

Browse Source
This commit is contained in:
Alex Pliutau 2021-04-10 17:49:27 +02:00
parent 36281c1526
commit 1e23f8dd7d
1 changed files with 301 additions and 47 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

348
README.md
View File

@ -2,97 +2,97 @@
[![Build Status](https://travis-ci.org/plutov/paypal.svg?branch=master)](https://travis-ci.org/plutov/paypal) [![Build Status](https://travis-ci.org/plutov/paypal.svg?branch=master)](https://travis-ci.org/plutov/paypal)
[![Godoc](http://img.shields.io/badge/godoc-reference-blue.svg?style=flat)](https://godoc.org/github.com/plutov/paypal) [![Godoc](http://img.shields.io/badge/godoc-reference-blue.svg?style=flat)](https://godoc.org/github.com/plutov/paypal)
## Go client for PayPal REST API # Go client for PayPal REST API
## Coverage ## Coverage
* POST /v1/oauth2/token * POST /v1/oauth2/token
* POST /v1/identity/openidconnect/tokenservice * POST /v1/identity/openidconnect/tokenservice
* GET /v1/identity/openidconnect/userinfo/?schema=**SCHEMA** * GET /v1/identity/openidconnect/userinfo/?schema=:schema
* POST /v1/payments/payouts * POST /v1/payments/payouts
* GET /v1/payments/payouts/**ID** * GET /v1/payments/payouts/:id
* GET /v1/payments/payouts-item/**ID** * GET /v1/payments/payouts-item/:id
* POST /v1/payments/payouts-item/**ID**/cancel * POST /v1/payments/payouts-item/:id/cancel
* GET /v1/payment-experience/web-profiles * GET /v1/payment-experience/web-profiles
* POST /v1/payment-experience/web-profiles * POST /v1/payment-experience/web-profiles
* GET /v1/payment-experience/web-profiles/**ID** * GET /v1/payment-experience/web-profiles/:id
* PUT /v1/payment-experience/web-profiles/**ID** * PUT /v1/payment-experience/web-profiles/:id
* DELETE /v1/payment-experience/web-profiles/**ID** * DELETE /v1/payment-experience/web-profiles/:id
* GET /v2/payments/authorizations/**ID** * GET /v2/payments/authorizations/:id
* POST /v2/payments/authorizations/**ID**/capture * POST /v2/payments/authorizations/:id/capture
* POST /v2/payments/authorizations/**ID**/void * POST /v2/payments/authorizations/:id/void
* POST /v2/payments/authorizations/**ID**/reauthorize * POST /v2/payments/authorizations/:id/reauthorize
* GET /v1/payments/sale/**ID** * GET /v1/payments/sale/:id
* POST /v1/payments/sale/**ID**/refund * POST /v1/payments/sale/:id/refund
* GET /v2/payments/refund/**ID** * GET /v2/payments/refund/:id
* POST /v1/reporting/transactions * POST /v1/reporting/transactions
### Vault ### Vault
* POST /v1/vault/credit-cards * POST /v1/vault/credit-cards
* DELETE /v1/vault/credit-cards/**ID** * DELETE /v1/vault/credit-cards/:id
* PATCH /v1/vault/credit-cards/**ID** * PATCH /v1/vault/credit-cards/:id
* GET /v1/vault/credit-cards/**ID** * GET /v1/vault/credit-cards/:id
* GET /v1/vault/credit-cards * GET /v1/vault/credit-cards
### Checkout ### Checkout
* POST /v2/checkout/orders * POST /v2/checkout/orders
* GET /v2/checkout/orders/**ID** * GET /v2/checkout/orders/:id
* PATCH /v2/checkout/orders/**ID** * PATCH /v2/checkout/orders/:id
* POST /v2/checkout/orders/**ID**/authorize * POST /v2/checkout/orders/:id/authorize
* POST /v2/checkout/orders/**ID**/capture * POST /v2/checkout/orders/:id/capture
### Billing plans (payments) ### Billing plans (payments)
* GET /v1/payments/billing-plans * GET /v1/payments/billing-plans
* POST /v1/payments/billing-plans * POST /v1/payments/billing-plans
* PATCH /v1/payments/billing-plans/***ID*** * PATCH /v1/payments/billing-plans/:id
* POST /v1/payments/billing-agreements * POST /v1/payments/billing-agreements
* POST /v1/payments/billing-agreements/***TOKEN***/agreement-execute * POST /v1/payments/billing-agreements/:token/agreement-execute
### Notifications ### Notifications
* POST /v1/notifications/webhooks * POST /v1/notifications/webhooks
* GET /v1/notifications/webhooks * GET /v1/notifications/webhooks
* GET /v1/notifications/webhooks/**ID** * GET /v1/notifications/webhooks/:id
* PATCH /v1/notifications/webhooks/**ID** * PATCH /v1/notifications/webhooks/:id
* DELETE /v1/notifications/webhooks/**ID** * DELETE /v1/notifications/webhooks/:id
* POST /v1/notifications/verify-webhook-signature * POST /v1/notifications/verify-webhook-signature
### Products (Catalog) ### Products (Catalog)
* POST /v1/catalogs/products * POST /v1/catalogs/products
* PATCH /v1/catalogs/products/**ID** * PATCH /v1/catalogs/products/:id
* GET /v1/catalogs/products/**ID** * GET /v1/catalogs/products/:id
* GET /v1/catalogs/products * GET /v1/catalogs/products
### Billing Plans (Subscriptions) ### Billing Plans (Subscriptions)
* POST /v1/billing/plans * POST /v1/billing/plans
* PATCH /v1/billing/plans/**ID** * PATCH /v1/billing/plans/:id
* GET /v1/billing/plans/**ID** * GET /v1/billing/plans/:id
* GET /v1/billing/plans * GET /v1/billing/plans
* POST /v1/billing/plans/**ID**/activate * POST /v1/billing/plans/:id/activate
* POST /v1/billing/plans/**ID**/deactivate * POST /v1/billing/plans/:id/deactivate
* POST /v1/billing/plans/**ID**/update-pricing-schemes * POST /v1/billing/plans/:id/update-pricing-schemes
### Subscriptions ### Subscriptions
* POST /v1/billing/subscriptions * POST /v1/billing/subscriptions
* PATCH /v1/billing/subscriptions/**ID** * PATCH /v1/billing/subscriptions/:id
* GET /v1/billing/subscriptions/**ID** * GET /v1/billing/subscriptions/:id
* POST /v1/billing/subscriptions/**ID**/activate * POST /v1/billing/subscriptions/:id/activate
* POST /v1/billing/subscriptions/**ID**/cancel * POST /v1/billing/subscriptions/:id/cancel
* POST /v1/billing/subscriptions/**ID**/revise * POST /v1/billing/subscriptions/:id/revise
* POST /v1/billing/subscriptions/**ID**/capture * POST /v1/billing/subscriptions/:id/capture
* POST /v1/billing/subscriptions/**ID**/suspend * POST /v1/billing/subscriptions/:id/suspend
* GET /v1/billing/subscriptions/**ID**/transactions * GET /v1/billing/subscriptions/:id/transactions
### Missing endpoints ## Missing endpoints
It is possible that some endpoints are missing in this SDK Client, but you can use built-in **paypal** functions to perform a request: **NewClient -> NewRequest -> SendWithAuth** It is possible that some endpoints are missing in this Client, but you can use built-in `paypal` functions to perform a request: `NewClient -> NewRequest -> SendWithAuth`
### Usage ## Usage
```go ```go
import "github.com/plutov/paypal/v4" import "github.com/plutov/paypal/v4"
@ -104,7 +104,261 @@ c.SetLog(os.Stdout) // Set log to terminal stdout
accessToken, err := c.GetAccessToken(context.Background()) accessToken, err := c.GetAccessToken(context.Background())
``` ```
### How to Contribute ## Get authorization by ID
```go
auth, err := c.GetAuthorization("2DC87612EK520411B")
```
### Capture authorization
```go
capture, err := c.CaptureAuthorization(authID, &paypal.Amount{Total: "7.00", Currency: "USD"}, true)
```
### Void authorization
```go
auth, err := c.VoidAuthorization(authID)
```
### Reauthorize authorization
```go
auth, err := c.ReauthorizeAuthorization(authID, &paypal.Amount{Total: "7.00", Currency: "USD"})
```
### Get Sale by ID
```go
sale, err := c.GetSale("36C38912MN9658832")
```
### Refund Sale by ID
```go
// Full
refund, err := c.RefundSale(saleID, nil)
// Partial
refund, err := c.RefundSale(saleID, &paypal.Amount{Total: "7.00", Currency: "USD"})
```
### Get Refund by ID
```go
refund, err := c.GetRefund("O-4J082351X3132253H")
```
### Get Order by ID
```go
order, err := c.GetOrder("O-4J082351X3132253H")
```
### Create an Order
```go
order, err := c.CreateOrder(paypal.OrderIntentCapture, []paypal.PurchaseUnitRequest{paypal.PurchaseUnitRequest{ReferenceID: "ref-id", Amount: paypal.Amount{Total: "7.00", Currency: "USD"}}})
```
### Update Order by ID
```go
order, err := c.UpdateOrder("O-4J082351X3132253H", []paypal.PurchaseUnitRequest{})
```
### Authorize Order
```go
auth, err := c.AuthorizeOrder(orderID, paypal.AuthorizeOrderRequest{})
```
### Capture Order
```go
capture, err := c.CaptureOrder(orderID, paypal.CaptureOrderRequest{})
```
### Identity
```go
token, err := c.GrantNewAccessTokenFromAuthCode("<Authorization-Code>", "http://example.com/myapp/return.php")
// ... or by refresh token
token, err := c.GrantNewAccessTokenFromRefreshToken("<Refresh-Token>")
```
### Retreive user information
```go
userInfo, err := c.GetUserInfo("openid")
```
### Create single payout to email
```go
payout := paypal.Payout{
SenderBatchHeader: &paypal.SenderBatchHeader{
EmailSubject: "Subject will be displayed on PayPal",
},
Items: []paypal.PayoutItem{
paypal.PayoutItem{
RecipientType: "EMAIL",
Receiver: "single-email-payout@mail.com",
Amount: &paypal.AmountPayout{
Value: "15.11",
Currency: "USD",
},
Note: "Optional note",
SenderItemID: "Optional Item ID",
},
},
}
payoutResp, err := c.CreateSinglePayout(payout)
```
### Get payout by ID
```go
payout, err := c.GetPayout("PayoutBatchID")
```
### Get payout item by ID
```go
payoutItem, err := c.GetPayoutItem("PayoutItemID")
```
### Cancel unclaimed payout item by ID
```go
payoutItem, err := c.CancelPayoutItem("PayoutItemID")
```
### Create web experience profile
```go
webprofile := WebProfile{
Name: "YeowZa! T-Shirt Shop",
Presentation: Presentation{
BrandName: "YeowZa! Paypal",
LogoImage: "http://www.yeowza.com",
LocaleCode: "US",
},
InputFields: InputFields{
AllowNote: true,
NoShipping: NoShippingDisplay,
AddressOverride: AddrOverrideFromCall,
},
FlowConfig: FlowConfig{
LandingPageType: LandingPageTypeBilling,
BankTXNPendingURL: "http://www.yeowza.com",
},
}
result, err := c.CreateWebProfile(webprofile)
```
### Get web experience profile
```go
webprofile, err := c.GetWebProfile("XP-CP6S-W9DY-96H8-MVN2")
```
### List web experience profile
```go
webprofiles, err := c.GetWebProfiles()
```
### Update web experience profile
```go
webprofile := WebProfile{
ID: "XP-CP6S-W9DY-96H8-MVN2",
Name: "Shop YeowZa! YeowZa! ",
}
err := c.SetWebProfile(webprofile)
```
### Delete web experience profile
```go
err := c.DeleteWebProfile("XP-CP6S-W9DY-96H8-MVN2")
```
### Vault
```go
// Store CC
c.StoreCreditCard(paypal.CreditCard{
Number: "4417119669820331",
Type: "visa",
ExpireMonth: "11",
ExpireYear: "2020",
CVV2: "874",
FirstName: "Foo",
LastName: "Bar",
})
// Delete it
c.DeleteCreditCard("CARD-ID-123")
// Edit it
c.PatchCreditCard("CARD-ID-123", []paypal.CreditCardField{
paypal.CreditCardField{
Operation: "replace",
Path: "/billing_address/line1",
Value: "New value",
},
})
// Get it
c.GetCreditCard("CARD-ID-123")
// Get all stored credit cards
c.GetCreditCards(nil)
```
### Webhooks
```go
// Create a webhook
c.CreateWebhook(paypal.CreateWebhookRequest{
URL: "webhook URL",
EventTypes: []paypal.WebhookEventType{
paypal.WebhookEventType{
Name: "PAYMENT.AUTHORIZATION.CREATED",
},
},
})
// Update a registered webhook
c.UpdateWebhook("WebhookID", []paypal.WebhookField{
paypal.WebhookField{
Operation: "replace",
Path: "/event_types",
Value: []interface{}{
map[string]interface{}{
"name": "PAYMENT.SALE.REFUNDED",
},
},
},
})
// Get a registered webhook
c.GetWebhook("WebhookID")
// Delete a webhook
c.DeleteWebhook("WebhookID")
// List registered webhooks
c.ListWebhooks(paypal.AncorTypeApplication)
```
## How to Contribute
* Fork a repository * Fork a repository
* Add/Fix something * Add/Fix something
@ -116,7 +370,7 @@ Current contributors:
- [Roopak Venkatakrishnan](https://github.com/roopakv) - [Roopak Venkatakrishnan](https://github.com/roopakv)
- [Alex Pliutau](https://github.com/plutov) - [Alex Pliutau](https://github.com/plutov)
### Tests ## Tests
* Unit tests: `go test -v ./...` * Unit tests: `go test -v ./...`
* Integration tests: `go test -tags=integration` * Integration tests: `go test -tags=integration`