Paypal API
  1. Webhooks
Paypal API
  • Authorization
    • Generate access_token
      POST
    • Terminate access_token
      POST
    • User Info
      GET
    • Generate client_token
      POST
  • Orders
    • Create order
      POST
    • Show order details
      GET
    • Update order
      PATCH
    • Authorize payment for order
      POST
    • Capture payment for order
      POST
  • Payments
    • Show details for authorized payment
      GET
    • Reauthorize authorized payment
      POST
    • Void authorized payment
      POST
    • Capture authorized payment
      POST
    • Show captured payment details
      GET
    • Refund captured payment
      POST
    • Show refund details
      GET
  • Invoices
    • Invoices
      • Generate invoice number
      • Create draft invoice
      • Show invoice details
      • List invoices
      • Generate QR code
      • Fully update invoice
      • Send invoice
      • Send invoice reminder
      • Cancel sent invoice
      • Delete invoice
      • Search for invoices
      • Record payment for invoice
      • Delete external payment
      • Record refund for invoice
      • Delete external refund
    • Templates
      • List templates
      • Create template
      • Show template details
      • Fully update template
      • Delete template
  • Subscriptions
    • Catalog Products
      • Create product
      • List products
      • Show product details
      • Update product
    • Plans
      • Create plan
      • List plans
      • Show plan details
      • Update plan
      • Deactivate plan
      • Activate plan
      • Update pricing
    • Subscriptions
      • Create subscription
      • Show subscription details
      • Update subscription
      • Revise plan or quantity of subscription
      • Suspend subscription
      • Activate subscription
      • Cancel subscription
      • Capture authorized payment on subscription
      • List transactions for subscription
  • Payouts
    • Create batch payout
    • Show payout batch details
    • Show payout item details
    • Cancel unclaimed payout item
  • Webhooks
    • List available events
      GET
    • Create webhook
      POST
    • List webhooks
      GET
    • Show webhook details
      GET
    • List event notifications
      GET
    • List event subscriptions for webhook
      GET
    • Show event notification details
      GET
    • Trigger a sample event
      POST
    • Verify webhook signature
      POST
    • Resend event notification
      POST
    • Simulate webhook event
      POST
    • Update webhook
      PATCH
    • Delete webhook
      DELETE
  • Shipment Tracking
    • Add tracking information for multiple PayPal transactions
    • Show tracking information
    • Update or cancel tracking information for PayPal transaction
  • Transaction Search
    • List transactions
    • List all balances
  • Disputes
    • List disputes
    • Show dispute details
    • Accept claim
    • Appeal dispute
    • Settle dispute
    • Update dispute status
    • Make offer to resolve dispute
    • Provide evidence
    • Acknowledge returned item
    • Provide supporting information for dispute
    • Escalate dispute to claim
    • Accept offer to resolve dispute
    • Send message about dispute to other party
    • Deny offer to resolve dispute
    • Partially update dispute
  • Onboarding (Limited Release)
    • Manage Accounts
      • Create managed account
      • Search managed account through external id
      • Search managed account by Seller Id
      • Partially updates information for a managed account
      • Shows collection of registered wallet domains
  1. Webhooks

Create webhook

POST
/v1/notifications/webhooks
Subscribes your webhook listener to events. For testing create a sample webhook endpoint on https://pipedream.com/ to receive webhook events sent by PayPal.

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Basic 之后拼接空格,以及经过 Base64 编码的 username:password
示例:
Authorization: Basic *****************
Header 参数
Content-Type
string 
必需
The Content-Type header field is used to specify the nature of the data in the body of an entity. PayPal REST APIs support application/json.
示例值:
application/json
PayPal-Request-Id
string 
必需
The server stores keys for 6 hours. The API callers can request the times to up to 72 hours by speaking to their Account Manager.
示例值:
{{$guid}}
Body 参数application/json
url
string 
必需
event_types
array [object {1}] 
必需
name
string 
可选
示例
{
  "url": "{{webhook_url}}",
  "event_types": [
    {
      "name": "*"
    }
  ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-m.sandbox.paypal.com/v1/notifications/webhooks' \
--header 'PayPal-Request-Id: ' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "url": "{{webhook_url}}",
    "event_types": [
        {
            "name": "*"
        }
    ]
}'

返回响应

🟢201201 - Create Webhook
application/json
Body
id
string 
必需
url
string 
必需
event_types
array [object {2}] 
必需
name
string 
可选
description
string 
可选
links
array [object {3}] 
必需
href
string 
必需
rel
string 
必需
method
string 
必需
示例
{
  "id": "1AV998667T7275054",
  "url": "https://enllwl46eqmr.x.pipedream.net",
  "event_types": [
    {
      "name": "*",
      "description": "ALL"
    }
  ],
  "links": [
    {
      "href": "https://api.sandbox.paypal.com/v1/notifications/webhooks/1AV998667T7275054",
      "rel": "self",
      "method": "GET"
    },
    {
      "href": "https://api.sandbox.paypal.com/v1/notifications/webhooks/1AV998667T7275054",
      "rel": "update",
      "method": "PATCH"
    },
    {
      "href": "https://api.sandbox.paypal.com/v1/notifications/webhooks/1AV998667T7275054",
      "rel": "delete",
      "method": "DELETE"
    }
  ]
}
🟢201201 - Create Webhook for Managed Accounts
🟠400400 Bad Request - Invalid URL
🟠400400 Bad Request - Webhook Already Exists
🟠400400 Bad Request - Webhook Limit Exceeded
🟠401401 Unauthorized - Invalid Token
修改于 2023-08-16 07:18:59
上一页
List available events
下一页
List webhooks
Built with