Go client for PayPal REST API
Currently supports v2 only, if you want to use v1, use v1.1.4 git tag.
Coverage
- POST /v1/oauth2/token
- POST /v1/identity/openidconnect/tokenservice
- GET /v1/identity/openidconnect/userinfo/?schema=SCHEMA
- POST /v1/payments/payouts
- GET /v1/payments/payouts/ID
- GET /v1/payments/payouts-item/ID
- POST /v1/payments/payouts-item/ID/cancel
- GET /v1/payment-experience/web-profiles
- POST /v1/payment-experience/web-profiles
- GET /v1/payment-experience/web-profiles/ID
- PUT /v1/payment-experience/web-profiles/ID
- DELETE /v1/payment-experience/web-profiles/ID
- POST /v1/vault/credit-cards
- DELETE /v1/vault/credit-cards/ID
- PATCH /v1/vault/credit-cards/ID
- GET /v1/vault/credit-cards/ID
- GET /v1/vault/credit-cards
- GET /v2/payments/authorizations/ID
- POST /v2/payments/authorizations/ID/capture
- POST /v2/payments/authorizations/ID/void
- POST /v2/payments/authorizations/ID/reauthorize
- GET /v2/payments/sale/ID
- POST /v2/payments/sale/ID/refund
- GET /v2/payments/refund/ID
- POST /v2/checkout/orders
- GET /v2/checkout/orders/ID
- PATCH /v2/checkout/orders/ID
- POST /v2/checkout/orders/ID/authorize
- POST /v2/checkout/orders/ID/capture
- GET /v2/payments/billing-plans
- POST /v2/payments/billing-plans
- PATCH /v2/payments/billing-plans/ID
- POST /v2/payments/billing-agreements
- POST /v2/payments/billing-agreements/TOKEN/agreement-execute
- POST /v1/notifications/verify-webhook-signature
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
New Client
import "github.com/plutov/paypal"
c, err := paypal.NewClient("clientID", "secretID", paypal.APIBaseSandBox)
c.SetLog(os.Stdout)
accessToken, err := c.GetAccessToken()
Get authorization by ID
auth, err := c.GetAuthorization("2DC87612EK520411B")
Capture authorization
capture, err := c.CaptureAuthorization(authID, &paypal.Amount{Total: "7.00", Currency: "USD"}, true)
Void authorization
auth, err := c.VoidAuthorization(authID)
Reauthorize authorization
auth, err := c.ReauthorizeAuthorization(authID, &paypal.Amount{Total: "7.00", Currency: "USD"})
Get Sale by ID
sale, err := c.GetSale("36C38912MN9658832")
Refund Sale by ID
refund, err := c.RefundSale(saleID, nil)
refund, err := c.RefundSale(saleID, &paypal.Amount{Total: "7.00", Currency: "USD"})
Get Refund by ID
refund, err := c.GetRefund("O-4J082351X3132253H")
Get Order by ID
order, err := c.GetOrder("O-4J082351X3132253H")
Create an Order
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
order, err := c.UpdateOrder("O-4J082351X3132253H", []paypal.PurchaseUnitRequest{})
Authorize Order
auth, err := c.AuthorizeOrder(orderID, paypal.AuthorizeOrderRequest{})
Capture Order
capture, err := c.CaptureOrder(orderID, paypal.CaptureOrderRequest{})
Identity
token, err := c.GrantNewAccessTokenFromAuthCode("<Authorization-Code>", "http://example.com/myapp/return.php")
token, err := c.GrantNewAccessTokenFromRefreshToken("<Refresh-Token>")
Retreive user information
userInfo, err := c.GetUserInfo("openid")
Create single payout to email
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
payout, err := c.GetPayout("PayoutBatchID")
Get payout item by ID
payoutItem, err := c.GetPayoutItem("PayoutItemID")
Cancel unclaimed payout item by ID
payoutItem, err := c.CancelPayoutItem("PayoutItemID")
Create web experience profile
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
webprofile, err := c.GetWebProfile("XP-CP6S-W9DY-96H8-MVN2")
List web experience profile
webprofiles, err := c.GetWebProfiles()
Update web experience profile
webprofile := WebProfile{
ID: "XP-CP6S-W9DY-96H8-MVN2",
Name: "Shop YeowZa! YeowZa! ",
}
err := c.SetWebProfile(webprofile)
Delete web experience profile
err := c.DeleteWebProfile("XP-CP6S-W9DY-96H8-MVN2")
Vault
c.StoreCreditCard(paypal.CreditCard{
Number: "4417119669820331",
Type: "visa",
ExpireMonth: "11",
ExpireYear: "2020",
CVV2: "874",
FirstName: "Foo",
LastName: "Bar",
})
c.DeleteCreditCard("CARD-ID-123")
c.PatchCreditCard("CARD-ID-123", []paypal.CreditCardField{
paypal.CreditCardField{
Operation: "replace",
Path: "/billing_address/line1",
Value: "New value",
},
})
c.GetCreditCard("CARD-ID-123")
c.GetCreditCards(nil)
How to Contribute
- Fork a repository
- Add/Fix something
- Check that tests are passing
- Create PR
Current contributors:
Tests
- Unit tests:
go test -v ./...
- Integration tests:
go test -tags=integration