Paypal

paypal

Online payment system that allows money transfers and serves as an electronic alternative to traditional payment methods

Payment Processing Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (74)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Activate billing planPAYPAL_ACTIVATE_PLANAcción

Activates a billing plan in PayPal, making it available for subscription signups. Use this action when you have a billing plan in inactive state that you want to make available for new subscriptions. A successful activation returns HTTP 204 No Content with no response body. This action is idempotent - activating an already active plan returns success.

Parámetros de entrada

idstringObligatorio
The ID of the billing plan to activate.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Add Batch Tracking InformationPAYPAL_ADD_BATCH_TRACKERSAcción

Add tracking information for multiple PayPal transactions in a single request. Use this action when you need to add or update tracking information for one or more PayPal transactions. This is particularly useful for batch processing shipping updates when fulfilling multiple orders. The action supports up to 20 trackers per request. The response includes tracker identifiers for successfully processed entries and any errors for entries that failed validation or processing. **Required fields:** - trackers: An array containing at least one tracker object **Each tracker requires:** - transaction_id: The PayPal transaction ID - status: The shipment status (CLICKED, SHIPPED, DELIVERED, etc.)

Parámetros de entrada

trackersobject[]Obligatorio
An array of tracking information for one or more shipments. Maximum 20 trackers per request.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Cancel Invoice RemindersPAYPAL_CANCEL_REMINDERSAcción

Cancels the automatic payment reminders for a PayPal invoice. Use this action when you need to stop the automatic reminder emails from being sent to the payer for a particular invoice. This is useful when the invoice has been paid, is no longer relevant, or when you want to handle payment follow-ups manually. Note: This action only cancels future scheduled reminders. It does not affect reminders that have already been sent.

Parámetros de entrada

invoice_idstringObligatorio
The ID of the invoice for which to cancel the reminders.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Capture subscription paymentPAYPAL_CAPTURE_SUBSCRIPTION_PAYMENTAcción

Captures an authorized payment on a PayPal subscription. Use this action when you need to charge a subscriber for an outstanding balance or capture an authorized payment that was previously approved. This action captures payments for subscriptions that have an outstanding balance to be charged. The capture type must be OUTSTANDING_BALANCE, and you must provide the amount to capture along with a note explaining the reason for the charge.

Parámetros de entrada

idstringObligatorio
The ID of the subscription.
notestringObligatorio
The reason or note for the subscription charge.
amountobjectObligatorio
The charge amount from the subscriber.
capture_typestringObligatorioenum
The type of capture. Currently only OUTSTANDING_BALANCE is supported.
OUTSTANDING_BALANCE

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Charge Payment MethodPAYPAL_CHARGE_PAYMENT_METHODAcción

Charges a payment method and captures funds immediately using Braintree GraphQL API. Use this action when you need to charge a customer's stored payment method (credit card, PayPal account, Venmo account, etc.) and immediately capture the funds into your merchant account. This creates a Braintree transaction and begins the settlement process. The payment method ID should be obtained from a previous tokenization operation using the Braintree client SDK (e.g., `hostedFields.tokenize()` or PayPal button). Note: This action is irreversible once the transaction is successfully captured.

Parámetros de entrada

inputobjectObligatorio
The input containing the payment method ID and transaction details.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create invoicePAYPAL_CREATE_INVOICEAcción

Creates a PayPal draft invoice. Use this action when you need to create a new invoice that can be customized and sent to recipients. The invoice is created in DRAFT status and can be modified before being sent. **Required fields:** - detail.currency_code: The three-character currency code (e.g., "USD") **Optional fields:** - detail.invoice_number: Custom invoice number - detail.invoice_date: Date when invoice was issued - detail.note: Note to the payer - detail.terms_and_conditions: Payment terms - items: List of line items (name, quantity, unit_amount required) - primary_recipients: Billing information for recipients - amount: Invoice amount breakdown The created invoice can be modified, scheduled, or sent using other PayPal invoicing actions.

Parámetros de entrada

itemsobject[]
An array of invoice line items. Each item includes name, quantity, and unit amount. Maximum 100 items.
amountobject
The invoice amount summary including breakdown.
detailobjectObligatorio
The details of the invoice. Includes invoice number, date, currency code, and payment terms. The currency_code field is required.
invoicerobject
The invoicer business information that appears on the invoice.
due_amountobject
The currency and amount for a financial transaction.
configurationobject
Configuration for the invoice template.
primary_recipientsobject[]
The billing and shipping information for the recipients. Includes name, email, address, and phone.
additional_recipientsstring[]
An array of CC email addresses to which notifications are sent.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create PayPal paymentPAYPAL_CREATE_PAYMENTAcción

Creates a PayPal payment using the v1 Payments API. Use this action when you need to create a payment to be processed through PayPal. This action is for the deprecated v1 API - consider using the v2 Payments API for new integrations. The action returns the created payment object including approval URLs for the buyer to complete the payment. After the buyer approves the payment, execute it to complete the transaction. Note: This is an irreversible operation once the payment is executed.

Parámetros de entrada

payerobjectObligatorio
The payer information including payment method.
intentstringObligatorioenum
The payment intent. Must be 'sale' for immediate payment, 'authorize' for payment authorization, or 'order' for creating an order.
saleauthorizeorder
transactionsobject[]Obligatorio
List of transaction details including amount and description.
redirect_urlsobject
Redirect URLs for the payment.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create billing plan (legacy)PAYPAL_CREATE_PAYMENTS_BILLING_PLANSAcción

Creates a PayPal billing plan using the legacy payments API (POST /v1/payments/billing-plans). Use this action when setting up a new billing plan for PayPal billing agreements, including plans with trial periods, regular billing cycles, and custom payment preferences. After creation, the plan must be activated via the activate_plan action before it can be used in billing agreements. Note: This uses the legacy /v1/payments/billing-plans endpoint. For newer integrations, consider using the /v1/billing/plans endpoint instead.

Parámetros de entrada

namestringObligatorio
The billing plan name. Must be 1-256 characters.
typestringObligatorioenum
The type of the billing plan. One of: FIXED, INFINITE.
FIXEDINFINITE
termsobject[]
An array of terms for the billing plan.
descriptionstringObligatorio
The detailed description of the billing plan. Must be 1-127 characters.
payment_definitionsobject[]Obligatorio
An array of payment definitions for the billing plan. Includes trial and regular payment configurations.
merchant_preferencesobjectObligatorio
The merchant preferences for the billing plan, including setup fee, return URL, and cancel URL.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a billing planPAYPAL_CREATE_PLANAcción

Creates a PayPal billing plan for subscription billing. Use this action when setting up new subscription pricing plans in PayPal, including plans with trial periods, regular billing cycles, and custom payment preferences. The plan must be associated with an existing product. The action returns the created plan object with its unique ID and status.

Parámetros de entrada

namestringObligatorio
The plan name. Must be 1-127 characters.
taxesobject
Tax configuration for the plan.
statusstringenum
Initial state of the plan.
CREATEDINACTIVEACTIVE
product_idstringObligatorio
The ID of the product created through the Catalog Products API. PayPal-generated IDs are 22 characters (e.g. PROD-...) but custom IDs may be 6-50 characters.
descriptionstring
The detailed description of the plan. Must be 1-127 characters.
billing_cyclesobject[]Obligatorio
An array of billing cycles for trial billing and regular billing. A plan can have at most two trial cycles and only one regular cycle.
quantity_supportedboolean
Indicates whether you can subscribe to this plan by providing a quantity for the goods or service.
payment_preferencesobjectObligatorio
The payment preferences for a subscription.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create ProductPAYPAL_CREATE_PRODUCTAcción

Creates a new product in PayPal's catalog. Use when you need to set up a product that can be used with PayPal's subscription or payment services. The product can be physical goods, digital goods, or a service. Once created, you can associate plans and pricing with this product. Use this action when you want to create a new product entry in PayPal's catalog system for selling physical items, digital products, or services through PayPal's payment infrastructure.

Parámetros de entrada

idstring
The ID for the product. You can specify the SKU for the product. If omitted, the system generates an ID with the PROD- prefix.
namestringObligatorio
The product name. Required. Maximum 127 characters.
typestringenum
The product type. Indicates whether the product is physical or digital goods, or a service. Default: PHYSICAL.
PHYSICALDIGITALSERVICE
categorystringenum
The product category classification.
ACCESSORIESACCOUNTINGADULTADVERTISINGAIRLINESANTIQUESART_AND_CRAFT_SUPPLIESART_DEALERS_AND_GALLERIESARTS_AND_CRAFTSAUDIO_BOOKSAUTOMOTIVEBABIES_CLOTHING_AND_SUPPLIES+133
home_urlstring
The home page URL for the product. Must be a valid URI.
image_urlstring
The image URL for the product. Must be a valid URI.
descriptionstring
The product description. Maximum 256 characters.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create SubscriptionPAYPAL_CREATE_SUBSCRIPTIONAcción

Creates a new PayPal subscription based on a billing plan. Use this action when you need to set up a recurring billing subscription for a customer. The action returns a subscription ID and an approval URL where the subscriber must complete the subscription by logging into their PayPal account and confirming the payment. This action is irreversible once the subscriber approves the subscription. **Required fields:** - plan_id: The PayPal billing plan ID **Important:** - The subscriber will be redirected to PayPal to approve the subscription - Use the 'approve' link from the response to redirect the subscriber - The subscription status will be 'PENDING' until the subscriber approves it

Parámetros de entrada

planobject
An inline plan object to customize the subscription.
plan_idstringObligatorio
The ID of the plan for the subscription. Typically a PayPal plan ID like 'P-4BP00732K8416940FNHU6FGA'.
quantitystring
The quantity of the product in the subscription.
custom_idstring
The custom id for the subscription. Can be an invoice id.
start_timestring
The date and time when the subscription starts, in Internet date and time format (ISO 8601).
subscriberobject
The subscriber information for the subscription.
auto_renewalboolean
DEPRECATED. Indicates whether the subscription auto-renews after the billing cycles complete.
shipping_amountobject
The currency and amount for a financial transaction.
application_contextobject
The application context, which customizes the payer experience during the subscription approval process with PayPal.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create templatePAYPAL_CREATE_TEMPLATEAcción

Creates a PayPal invoice template. Use this action when you need to create a reusable invoice template that can be used to generate invoices with consistent settings. Templates are useful for businesses that regularly send similar invoices. **Required fields:** - name: The template name (must be unique) - template_info.detail.currency_code: The three-character ISO-4217 currency code **Optional fields:** - default_template: Set as the default template (only one allowed per account) - standard_template: Indicates if this is a custom template - template_info: Full template configuration - invoicer: Business information (email, tax_id, logo_url, etc.) - primary_recipients: Billing/shipping information for recipients - items: Line item presets - configuration: Tax settings, partial payment options - settings: Display preferences - unit_of_measure: QUANTITY, HOURS, or AMOUNT The created template can be used with the Generate Invoice action to quickly create invoices from pre-configured templates.

Parámetros de entrada

namestringObligatorio
The template name. Must be unique.
settingsobject[]
The template settings. Sets a template as the default template or edit template.
template_infoobject
The template details including invoicer business information, invoice recipients, items, and configuration.
unit_of_measurestringenum
The unit of measure for the invoiced item.
QUANTITYHOURSAMOUNT
default_templateboolean
Indicates whether this template is the default template. A invoicer can have one default template.
standard_templateboolean
Indicates whether this template is a invoicer-created custom template. The system generates non-custom templates.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a webhookPAYPAL_CREATE_WEBHOOKAcción

Creates a PayPal webhook endpoint to receive notifications about events. Use this action when you need to set up a webhook to receive real-time notifications about PayPal events such as payment completions, refunds, disputes, or subscription changes. The webhook URL must be publicly accessible and support HTTPS. The action returns the created webhook object including its unique ID for later reference.

Parámetros de entrada

urlstringObligatorio
The URL that is configured to listen on localhost for incoming POST notification messages that contain event information. The URL must be a valid HTTPS URL.
event_typesobject[]Obligatorio
An array of events to which to subscribe your webhook. To subscribe to all events, including events as they are added, specify the asterisk wild card '*' as the name. To list all supported events, use the List Available Events endpoint.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a webhook lookupPAYPAL_CREATE_WEBHOOK_LOOKUPAcción

Creates a new PayPal webhook lookup to verify a webhook signature. Use this action when you need to initiate a webhook lookup to validate that a webhook endpoint is correctly receiving and processing PayPal event notifications. This is useful for testing webhook configurations or verifying webhook authenticity before enabling it in production. This is a create operation that returns the newly created webhook lookup details, including the lookup ID, client ID, and related HATEOAS links. The action requires no input parameters.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a web experience profilePAYPAL_CREATE_WEB_PROFILEAcción

Creates a PayPal web experience profile for customizing checkout. Use this action when you need to set up a branded, customized checkout experience for PayPal payments. This includes configuring the landing page, branding elements like logo and brand name, input field customization, and checkout flow behavior. The profile can be set as temporary (persists for three hours) or permanent. To use this profile, pass its ID when creating a payment.

Parámetros de entrada

idstring
The ID of the web experience profile. If not provided, PayPal generates an ID.
namestringObligatorio
The web experience profile name. Must be unique for a set of profiles for a merchant.
temporaryboolean
Indicates whether the profile persists for three hours or permanently. Set to false for permanent persistence, true for three-hour persistence.
flow_configobject
The flow configuration parameters.
input_fieldsobject
The input field customization parameters.
presentationobject
The style and presentation parameters.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Deactivate PlanPAYPAL_DEACTIVATE_PLANAcción

Deactivates a PayPal billing plan, making it unavailable for new subscriptions while preserving existing subscriptions. Use this action when you need to stop offering a particular billing plan without deleting it. Existing subscriptions will continue to work, but no new subscriptions can be created with this plan. Note: Only plans in an ACTIVE state can be deactivated. Deactivated plans cannot be reactivated.

Parámetros de entrada

idstringObligatorio
The unique plan identifier. Required.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Invoice External PaymentPAYPAL_DELETE_EXTERNAL_PAYMENTAcción

Permanently deletes an external payment from a specified PayPal invoice. Use when you need to remove a specific external payment transaction that was incorrectly recorded on an invoice. This action is irreversible — once deleted, the payment record cannot be recovered. A successful deletion returns HTTP 204 No Content with no JSON response body. This action is idempotent — attempting to delete a non-existent payment record also returns success.

Parámetros de entrada

invoice_idstringObligatorio
The unique identifier of the invoice from which to delete the external payment. This is the invoice ID returned when creating or listing invoices.
transaction_idstringObligatorio
The unique identifier of the external payment transaction to delete. This is the transaction ID associated with the payment record on the invoice.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete InvoicePAYPAL_DELETE_INVOICEAcción

Deletes a PayPal invoice by its ID. Use this action when you need to permanently remove an invoice that is no longer needed. This action is irreversible — once deleted, the invoice cannot be recovered and any associated payment records will be lost. Note: Only draft invoices can be deleted. Attempting to delete an invoice that has been sent or paid will return an error.

Parámetros de entrada

invoice_idstringObligatorio
The ID of the invoice to delete.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete invoice payment recordPAYPAL_DELETE_INVOICE_PAYMENT_RECORDAcción

Deletes a payment record from a PayPal invoice. Use this action when you need to remove a specific payment transaction record that was incorrectly applied to an invoice. This action permanently removes the payment record from the invoice. This action is irreversible — once deleted, the payment record cannot be recovered. A successful deletion returns HTTP 204 No Content with no response body. This action is idempotent — attempting to delete a non-existent payment record also returns success.

Parámetros de entrada

invoice_idstringObligatorio
The ID of the invoice from which to delete the payment record.
transaction_idstringObligatorio
The ID of the payment transaction record to delete from the invoice.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Invoice Refund RecordPAYPAL_DELETE_INVOICE_REFUND_RECORDAcción

Permanently deletes a refund record from a specified PayPal invoice. This action is irreversible - once deleted, the refund record cannot be recovered. Use when correcting invoice payment records, removing erroneous refunds, or cleaning up invoice payment history. Note: This action only deletes the refund record reference from the invoice. It does not reverse or refund the actual payment through PayPal.

Parámetros de entrada

invoice_idstringObligatorio
The unique identifier of the invoice from which to delete the refund record. This is the invoice ID returned when creating or listing invoices.
transaction_idstringObligatorio
The unique identifier of the refund transaction to delete. This is the transaction ID associated with the refund record on the invoice.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Payment ResourcePAYPAL_DELETE_PAYMENT_RESOURCEAcción

Deletes a PayPal payment resource. Use when you need to permanently remove a payment resource that is no longer needed. This action is irreversible — the payment resource cannot be recovered once deleted. Note: Only payment resources in a valid state can be deleted. Attempting to delete a resource that is already deleted or does not exist will return an error.

Parámetros de entrada

payment_resource_idstringObligatorio
The unique payment resource identifier to delete. Typically starts with 'XD' followed by alphanumeric characters.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete TemplatePAYPAL_DELETE_TEMPLATEAcción

Deletes a PayPal invoice template by its ID. Use this action when you need to permanently remove an invoice template that is no longer needed. This action is irreversible — once deleted, the template cannot be recovered and will need to be recreated if needed again. Note: Only templates that are not currently in use can be deleted. Attempting to delete a template that is associated with active invoices may return an error.

Parámetros de entrada

template_idstringObligatorio
The ID of the template to delete.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete WebhookPAYPAL_DELETE_WEBHOOKAcción

Deletes a PayPal webhook by its ID. Use this action when you need to permanently remove a webhook endpoint that is no longer needed. This action is irreversible — once deleted, the webhook cannot be recovered and will stop receiving event notifications immediately. Note: Deleting a webhook does not affect any events that were already processed by that webhook. Only future events will be affected.

Parámetros de entrada

webhook_idstringObligatorio
The ID of the webhook to delete. This is the unique identifier returned when the webhook was created.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Web Experience ProfilePAYPAL_DELETE_WEB_PROFILEAcción

Deletes a PayPal web experience profile by its ID. Use this action when you need to permanently remove a web experience profile that is no longer needed. This action is irreversible — the web experience profile cannot be recovered once deleted. Note: Only web profiles that are not currently in use can be deleted. Attempting to delete a profile that is associated with an active resource will return an error.

Parámetros de entrada

idstringObligatorio
The ID of the web experience profile to delete. Typically starts with 'TXP-' followed by alphanumeric characters.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Fetch Braintree NodePAYPAL_FETCH_NODEAcción

Fetches any object that extends the Node interface using its ID. Use this action when you need to retrieve details about a specific Braintree resource (transaction, customer, payment method, etc.) by its global ID. This action performs a GraphQL query against the Braintree API to fetch the node and its associated data. Note: This action uses the Braintree GraphQL API endpoint at /graphql. The node ID should be the base64-encoded global ID from Braintree. Different node types return different fields in the response.

Parámetros de entrada

node_idstringObligatorio
The global ID of the node to fetch. This ID is the base64-encoded ID used by Braintree's GraphQL API.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Finalize Braintree DisputePAYPAL_FINALIZE_PAY_PAL_BRAINTREE_DISPUTEAcción

Finalizes a Braintree dispute after adding evidence, submitting it to the cardholder's bank for review. Use this action when you have finished adding evidence to an OPEN dispute and want to formally submit it for review. Only disputes with a status of OPEN can be finalized. This action must be performed before the reply-by date deadline. Once finalized, the dispute cannot be modified or additional evidence added. Note: This action uses the Braintree GraphQL API endpoint, which is separate from the standard PayPal REST API.

Parámetros de entrada

dispute_idstringObligatorio
The ID of the dispute to finalize. Only disputes with a status of OPEN can be finalized.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Find eligible PayPal payment methodsPAYPAL_FIND_ELIGIBLE_METHODSAcción

Find a list of eligible payment methods for a customer. Use this action when you need to determine which payment methods (such as PayPal, PayPal Credit, Pay Later, or Venmo) are available for a customer based on their country and purchase details. This is useful for displaying appropriate payment options during checkout or determining payment eligibility before creating an order. The response includes available payment methods and optionally vaulted tokens if the customer has saved payment instruments. **Common use cases:** - Pre-checkout payment method availability - Display appropriate payment options to customers - Determine eligible funding sources for a transaction

Parámetros de entrada

customerobject
Customer who is making a purchase from the merchant/partner.
preferencesobject
Preferences of merchant/partner consuming the API.
purchase_unitsobject[]Obligatorio
An array of purchase units for which to determine payment eligibility. Each unit includes amount and optionally payee information.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Generate PayPal Client TokenPAYPAL_GENERATE_CLIENT_TOKENAcción

Generate a client token for PayPal JavaScript SDK integration. Use this action when you need to obtain a client token for accepting PayPal payments on the client side. The client token is required when initializing the PayPal JS SDK (paypal.Buttons() or paypal.Messages()) in your web application. This action requires no request body parameters - the token is generated based on your authenticated credentials (Bearer token in Authorization header). Note: Client tokens are short-lived and should be fetched fresh before each checkout session. Do not cache or reuse client tokens across multiple sessions.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Generate Next Invoice NumberPAYPAL_GENERATE_NEXT_INVOICE_NUMBERAcción

Generates the next invoice number from PayPal's invoicing service. Use this action when you need to retrieve the next sequential invoice number in your customized format before creating an invoice. This ensures consistent invoice numbering across your PayPal invoices. Note: This action queries PayPal for the next available invoice number in your sequence. The format is configured in your PayPal account settings.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Generate Next Invoice Number (v2)PAYPAL_GENERATE_NEXT_INVOICE_NUMBER_V2Acción

Generates the next invoice number from PayPal's invoicing service using the v2 API. Use this action when you need to retrieve the next sequential invoice number in your customized format before creating an invoice. This ensures consistent invoice numbering across your PayPal invoices. Note: This action queries PayPal for the next available invoice number in your sequence. The format is configured in your PayPal account settings.

Parámetros de entrada

fetch_idboolean
Optional parameter to decide whether to fetch the next invoice number or ID. Set to true to fetch the ID, false or omitted for the number.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Generate Invoice QR CodePAYPAL_GENERATE_QR_CODEAcción

Generates a QR code image for a PayPal invoice using the v2 invoicing API. Use this action when you need to display a scannable QR code that customers can use to pay an invoice or view its details via the PayPal mobile app. The QR code contains encoded payment information that redirects users to PayPal to complete the transaction. **Customization options:** - Adjust dimensions using the `width` and `height` parameters (150-500 pixels) - Choose between payment URL (`action='pay'`) or details URL (`action='details'`) Note: This action uses the PayPal Invoicing API v2, which is the recommended version for new integrations.

Parámetros de entrada

widthinteger
The width, in pixels, of the QR code image. Value must be between 150 and 500 pixels.
actionstringenum
The type of URL for which to generate a QR code. - PAY: Generate a QR code for payment - DETAILS: Generate a QR code for viewing invoice details
paydetails
heightinteger
The height, in pixels, of the QR code image. Value must be between 150 and 500 pixels.
invoice_idstringObligatorio
The ID of the invoice for which to generate a QR code.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Billing SubscriptionsPAYPAL_GET_BILLING_SUBSCRIPTIONSAcción

Lists PayPal billing subscriptions for the merchant account. Use when you need to retrieve a paginated list of subscriptions, optionally filtered by creation date range, status, or plan ID. This action supports pagination via page and page_size parameters. Set total_required=true to include total item and page counts in the response.

Parámetros de entrada

pageinteger
A non-zero integer representing the page number of the result. Default: 1.
statusstringenum
Possible status values for a subscription.
APPROVAL_PENDINGAPPROVEDACTIVESUSPENDEDCANCELLEDEXPIRED
end_timestring
The end date and time for the subscription range, in Internet date and time format. Example: 2020-12-31T23:59:59Z.
page_sizeinteger
The number of items to return in the response. Default: 25, Maximum: 100.
start_timestring
The start date and time for the subscription range, in Internet date and time format. Example: 2020-01-01T00:00:00Z.
total_requiredboolean
Indicates whether to show the total items and total pages in the response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get InvoicePAYPAL_GET_INVOICEAcción

Retrieves detailed information about a specific PayPal invoice by its ID. Use this action when you need to get details about an existing invoice, such as its status, amount, line items, payment history, or refund information. This is useful for verifying invoice details, tracking payment status, or auditing invoice information. This is a read-only operation that returns the complete invoice details including invoicer information, recipient details, items, amounts, payments, refunds, and HATEOAS links for related actions. Note: The invoice ID is a path parameter, not a query parameter.

Parámetros de entrada

invoice_idstringObligatorio
The ID of the invoice to retrieve.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Invoice QR CodePAYPAL_GET_INVOICING_INVOICES_QR_CODEAcción

Generates a QR code image for a PayPal invoice. Use this action when you need to display a scannable QR code that customers can use to pay an invoice. The QR code contains encoded payment information that redirects customers to PayPal to complete the payment. You can customize the QR code dimensions using the width and height parameters. Note: The PayPal Invoicing v1 API is deprecated. Consider migrating to the v2 API for new integrations.

Parámetros de entrada

widthinteger
The width of the QR code image in pixels. The minimum value is 150 and the maximum value is 600.
actionstring
The action for the QR code. Can be 'pay' for payment or 'capture' for payment capture.
heightinteger
The height of the QR code image in pixels. The minimum value is 150 and the maximum value is 600.
invoice_idstringObligatorio
The ID of the invoice for which to generate a QR code.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Invoice TemplatePAYPAL_GET_INVOICING_TEMPLATEAcción

Retrieves detailed information about a specific PayPal invoice template by its ID. Use this action when you need to get details about an existing invoice template, such as its name, settings, template info (invoicer details, recipients, line items, amounts), or whether it is the default template. This is useful for verifying template configuration before creating invoices, auditing template settings, or retrieving template details for display purposes. This is a read-only operation that returns the complete template details including the template name, settings, template_info (invoicer business info, recipients, items, amounts, configuration), HATEOAS links, and whether it is a default or standard template. Note: The template_id is a path parameter, not a query parameter.

Parámetros de entrada

template_idstringObligatorio
The ID of the template to retrieve.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Payment DetailsPAYPAL_GET_PAYMENTAcción

Retrieves details for a PayPal payment by its ID using the deprecated v1 Payments API. Use when you need to check the status, payer information, transaction details, or related resources of an existing payment. This action is useful for verifying payment details, checking if a payment was approved, viewing transaction amounts, or accessing related sale/authorization/capture resources. Note that this is a deprecated v1 API endpoint — consider using the v2 Payments API for new integrations.

Parámetros de entrada

payment_idstringObligatorio
The ID of the payment to retrieve. This is the unique identifier assigned when a payment was created.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Refund DetailsPAYPAL_GET_PAYMENTS_REFUNDAcción

Retrieves details for a PayPal refund by its ID. Use when you need to check the status, amount, or details of an existing refund. This action is useful for verifying refund details, checking refund status, or monitoring refund progress. Note that this is a deprecated v1 API endpoint.

Parámetros de entrada

refund_idstringObligatorio
The ID of the refund to retrieve. This is the unique identifier assigned when a refund was created.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get PlanPAYPAL_GET_PLANAcción

Retrieves details for a specific PayPal billing plan by its ID. Use when you need to fetch information about an existing subscription plan, such as its pricing, billing cycles, status, or payment preferences.

Parámetros de entrada

idstringObligatorio
The unique PayPal-generated ID for the plan. Plan IDs start with 'P-' followed by alphanumeric characters.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get ProductPAYPAL_GET_PRODUCTAcción

Retrieves detailed information about a specific PayPal product by its ID. Use when you need to get details about a product, such as its name, description, category, or type. This action is useful for verifying product details before creating plans or subscriptions.

Parámetros de entrada

product_idstringObligatorio
The ID of the product to retrieve. This is the unique identifier assigned when the product was created.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Subscription DetailsPAYPAL_GET_SUBSCRIPTIONAcción

Retrieves the details of a PayPal subscription by its ID. Use this action when you need to check the status, billing information, subscriber details, or other properties of an existing subscription. Optionally, you can request additional fields like 'last_failed_payment' or 'plan' details using the fields parameter.

Parámetros de entrada

idstringObligatorio
The ID of the subscription to retrieve.
fieldsstring
A comma-separated list of additional fields to include in the response. Possible values are 'last_failed_payment' and 'plan'.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get PayPal User InfoPAYPAL_GET_USERINFOAcción

Retrieves user claims from PayPal using OpenID Connect. Use when you need to obtain authenticated user's profile information such as email, name, and address based on an access token. This endpoint returns user identity information associated with the OAuth access token provided in the Authorization header. The access token must have been obtained via OpenID Connect authentication flow. This action requires an access token with the 'openid' scope. The token is passed via the Authorization header (Bearer token), which is automatically injected from the auth_metadata.

Parámetros de entrada

claims_schemastringenum
The schema that defines the claims format.
paypalv1.userinfo-1.0openid

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get User InfoPAYPAL_GET_USER_INFOAcción

Retrieves user profile information from PayPal. Use when you need to get the authenticated user's profile details including name, email, address, and account verification status. The response is filtered by the specified schema. The only supported schema value is 'paypalv1.1', which returns the user information in a structured format.

Parámetros de entrada

schemastringenum
Supported schema values for user info response.
paypalv1.1

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get WebhookPAYPAL_GET_WEBHOOKAcción

Retrieves detailed information about a specific PayPal webhook by its ID. Use this action when you need to get details about an existing webhook configuration, such as the webhook URL, subscribed event types, or webhook status. This is useful for auditing webhook settings, verifying webhook subscriptions, or checking webhook configuration. This is a read-only operation that returns the webhook details including its ID, URL, subscribed event types, and HATEOAS links for related actions.

Parámetros de entrada

webhook_idstringObligatorio
The ID of the webhook to retrieve.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Webhook LookupPAYPAL_GET_WEBHOOK_LOOKUPAcción

Retrieves detailed information about a specific PayPal webhook lookup by its ID. Use this action when you need to get details about a webhook lookup, such as its associated client ID and related HATEOAS links. This is useful for verifying webhook lookup information or auditing webhook lookup records. This is a read-only operation that returns the webhook lookup details including the lookup ID, client ID, and related links for navigation.

Parámetros de entrada

webhook_lookup_idstringObligatorio
The ID of the webhook lookup to retrieve. This is the unique identifier assigned when the webhook lookup was created.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Web ProfilePAYPAL_GET_WEB_PROFILEAcción

Retrieves detailed information about a PayPal web experience profile by its ID. Use when you need to get details about an existing web experience profile, such as its name, flow configuration, input field settings, or presentation style. This is useful for auditing profile settings, verifying configurations, or retrieving profile information before updating. This is a read-only operation that returns the web profile details including its ID, name, flow config, input fields, presentation settings, and temporary status.

Parámetros de entrada

idstringObligatorio
The ID of the web experience profile to retrieve.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List PayPal DisputesPAYPAL_LIST_DISPUTESAcción

List PayPal customer disputes with optional filtering by date, transaction, or state. Use when you need to retrieve a paginated list of PayPal disputes. You can filter by creation date, transaction ID, dispute state, or update time range. Results are sorted by creation time (newest first). Use the next_page_token from response links to paginate through additional results.

Parámetros de entrada

page_sizeinteger
Limits the number of disputes in the response. Maximum allowed value is typically 100.
start_timestring
Filters the disputes by creation date and time. The start time must be within the last 180 days. Format: ISO 8601 (e.g., yyyy-MM-ddTHH:mm:ss.SSSZ). You can specify either start_time or disputed_transaction_id, but not both.
dispute_statestring[]
Filters the disputes by one or more dispute states. Separate multiple values with comma or provide as a list. When multiple states are specified, disputes matching any of the states are returned.
next_page_tokenstring
A token that describes the next page of results to fetch. Use the token from the previous response's HATEOAS links.
update_time_afterstring
Filters disputes updated after this date and time. Must be within the last 180 days. Default is 180 days ago. Format: ISO 8601.
update_time_beforestring
Filters disputes updated before this date and time. Must be within the last 180 days. Default is current time. Format: ISO 8601.
disputed_transaction_idstring
Filters the disputes by a transaction ID. You can specify either start_time or disputed_transaction_id, but not both.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List PayPal InvoicesPAYPAL_LIST_INVOICESAcción

List invoices from PayPal with pagination support. Use when you need to retrieve a paginated list of PayPal invoices. You can control the number of results per page using page_size, navigate through pages using page, and optionally include total counts in the response by setting total_required=true. This action supports filtering fields to return either all invoice details (fields='all') or only the essential information like name, ID, and defaults (fields='none').

Parámetros de entrada

pageinteger
The page number to be retrieved. A combination of page=1 and page_size=20 returns the first 20 templates. A combination of page=2 and page_size=20 returns the next 20 templates.
fieldsstringenum
Fields to return in the response.
allnone
page_sizeinteger
The maximum number of templates to return in the response.
total_requiredboolean
Indicates whether to show total_pages and total_items in the response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Legacy Billing PlansPAYPAL_LIST_LEGACY_BILLING_PLANSAcción

Lists billing plans using the legacy PayPal payments API (v1/payments/billing-plans). Use when you need to retrieve billing plans created with the legacy PayPal billing agreements API. This is a read-only operation that returns plan details including payment definitions, merchant preferences, and status. Note: This action uses the legacy API endpoint. For newer integrations, consider using the /v1/billing/plans endpoint instead.

Parámetros de entrada

pageinteger
A non-zero integer which is the start index of the entire list of items to return in the response.
statusstringenum
Possible states of a billing plan in the legacy API.
CREATEDACTIVEINACTIVEDELETED
end_timestring
The end date and time for the range to consider, in ISO 8601 format (e.g., 2024-12-31T23:59:59Z).
page_sizeinteger
The number of items to return in the response. Defaults to 25.
start_timestring
The start date and time for the range to consider, in ISO 8601 format (e.g., 2024-01-01T00:00:00Z).
total_requiredboolean
Indicates whether to show the total count in the response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List PaymentsPAYPAL_LIST_PAYMENTSAcción

Lists payment information for authorized payments. Use when you need to retrieve a list of PayPal payments with optional filtering by time, payer, or status. This action is useful for reconciling transactions, monitoring payment states, and building payment dashboards. Results are paginated and can be filtered by various criteria including creation time, payer ID, and payment status. NOTE: This endpoint is deprecated. For new integrations, use /v1/payments/captures and /v1/payments/authorizations instead.

Parámetros de entrada

countinteger
The number of items to return. Default: 10. Maximum: 20.
statusstringenum
Payment status values.
CREATEDAPPROVEDFAILEDPAYER_ACTION_REQUIRED
end_timestring
Filters payments created before this date and time (ISO 8601 format).
payer_idstring
Filters payments by the PayPal account ID of the payer.
start_idstring
The ID of the starting payment in a paginated result set.
start_timestring
Filters payments created after this date and time (ISO 8601 format).
start_indexinteger
The index of the first payment to return. Must be a multiple of count.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List billing plansPAYPAL_LIST_PLANSAcción

Lists billing plans from PayPal with optional filtering and pagination. Use this action when you need to retrieve available billing plans for subscription products. This is a read-only operation that returns plan details including pricing, billing cycles, and status. Results can be filtered by product_id and paginated using page and page_size parameters. The response includes HATEOAS links for navigating between pages and performing related actions (e.g., activate, deactivate, update plan).

Parámetros de entrada

pageinteger
A non-zero integer which is the start index of the entire list of items to return in the response. The combination of page=1 and page_size=20 returns the first 20 items.
page_sizeinteger
The number of items to return in the response. Defaults to 25.
product_idstring
Filters the response by a Product ID.
total_requiredboolean
Indicates whether to show the total count in the response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List PayPal ProductsPAYPAL_LIST_PRODUCTSAcción

List products from the PayPal product catalog. Use when you need to retrieve a paginated list of products with their details, such as product IDs, names, and descriptions. This action supports pagination via page_size and page parameters. Set total_required=true to include total item and page counts in the response.

Parámetros de entrada

pageinteger
A non-zero integer which is the start index of the entire list of items that are returned in the response.
page_sizeinteger
The number of items to return in the response. Defaults to 10.
total_requiredboolean
Indicates whether to show the total items and total pages in the response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List PayPal Invoice TemplatesPAYPAL_LIST_TEMPLATESAcción

List invoice templates from PayPal. Use when you need to retrieve a paginated list of PayPal invoice templates with their details. This is a read-only operation that returns template information including names, IDs, settings, and default status. The action supports pagination via page and page_size parameters, and you can control which fields are returned using the fields parameter (set to 'none' for minimal template info).

Parámetros de entrada

pageinteger
The page number to be retrieved, for the list of templates. A combination of page=1 and page_size=20 returns the first 20 templates.
fieldsstringenum
Fields to return in the response.
allnone
page_sizeinteger
The maximum number of templates to return in the response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List webhook event typesPAYPAL_LIST_WEBHOOK_EVENT_TYPESAcción

Lists all available PayPal webhook event types to which you can subscribe. Use this action when you need to discover all webhook events available in the PayPal API before creating or configuring webhooks. This is useful for initial setup or when you need to display available webhook options to users. The endpoint requires no parameters and returns the full list of supported event types with their descriptions and statuses. This is a read-only operation that queries available events without modifying anything.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List webhook event type subscriptionsPAYPAL_LIST_WEBHOOK_EVENT_TYPE_SUBSCRIPTIONSAcción

Lists event type subscriptions for a specific PayPal webhook. Use this action when you need to retrieve the list of event types to which a specific webhook is subscribed. This is useful for auditing webhook configurations, verifying which events a webhook is set up to receive, or checking the status of event subscriptions. Unlike the ListWebhookEventTypes action which lists all available event types, this action returns only the event types that a specific webhook is subscribed to. This is a read-only operation that does not modify any webhook configuration.

Parámetros de entrada

webhook_idstringObligatorio
The ID of the webhook for which to list event type subscriptions.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List webhook lookupsPAYPAL_LIST_WEBHOOK_LOOKUPSAcción

Lists all webhook lookups associated with your PayPal application. Use this action when you need to retrieve webhook lookups that have been configured for your application. This is useful for auditing webhook configurations, verifying lookup status, or checking which client IDs have registered webhooks. This is a read-only operation that returns webhook lookup details including IDs, client IDs, and HATEOAS links for related actions. The action requires no input parameters.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List WebhooksPAYPAL_LIST_WEBHOOKSAcción

Lists webhooks configured for an application or PayPal account. Use this action when you need to retrieve all webhooks that have been created and configured in your PayPal integration. This is useful for auditing existing webhook configurations, verifying webhook subscriptions, or checking webhook status. The results can be filtered by anchor_type to show webhooks for the application (APPLICATION) or a specific account (ACCOUNT). This is a read-only operation that returns webhook details including URLs, subscribed event types, and HATEOAS links for related actions.

Parámetros de entrada

anchor_typestringenum
The type of entity to use as an anchor for filtering webhooks.
APPLICATIONACCOUNT

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List web experience profilesPAYPAL_LIST_WEB_PROFILESAcción

Lists web experience profiles from PayPal with optional pagination. Use this action when you need to retrieve available web experience profiles for customizing the checkout experience. This is a read-only operation that returns profile details including flow configuration, input field settings, and branding options. Results can be paginated using page and page_size parameters. The response includes up to 20 profiles by default (configurable via page_size), with HATEOAS links for pagination if more results exist.

Parámetros de entrada

pageinteger
A non-zero integer which is the start index of the entire list of items to return.
page_sizeinteger
The number of items to return in the response. Defaults to 25. Maximum is 20.
total_requiredboolean
Indicates whether to show the total count in the response.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update checkout order (partial)PAYPAL_PATCH_ORDERSAcción

Partially updates a PayPal checkout order using JSON Patch (RFC 6902) operations. Use this action when you need to update specific fields of an existing checkout order without replacing the entire resource. This action accepts an array of patch operations (add, remove, replace, move, copy, test) and applies them to the checkout order. Common use cases include updating the order description, custom fields, or other patchable properties. A successful update returns HTTP 204 No Content with no JSON response body. This action is idempotent - applying the same patch multiple times produces the same result.

Parámetros de entrada

idstringObligatorio
The ID of the checkout order to update.
operationsobject[]Obligatorio
An array of JSON Patch operations to apply to the order. Each operation follows RFC 6902 format with 'op', 'path', and optionally 'value'.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update billing plan (partial)PAYPAL_PATCH_PLANAcción

Partially updates a PayPal billing plan using JSON Patch (RFC 6902) operations. Use this action when you need to update specific fields of a billing plan without replacing the entire resource. This action accepts an array of patch operations (add, remove, replace, move, copy, test) and applies them to the billing plan. Common use cases include updating the plan name, description, payment definitions, or other fields. A successful update returns HTTP 204 No Content with no JSON response body. This action is idempotent - applying the same patch multiple times produces the same result.

Parámetros de entrada

idstringObligatorio
The unique billing plan ID.
patchesobject[]Obligatorio
An array of JSON Patch operations to apply to the billing plan. Each operation follows RFC 6902 format with 'op', 'path', and optionally 'value'.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update SubscriptionPAYPAL_PATCH_SUBSCRIPTIONAcción

Update a PayPal subscription using JSON Patch operations. Use when you need to modify specific fields of an existing subscription such as custom_id, billing_token, shipping_address, or other patchable properties. This action applies partial updates to the subscription using RFC 6902 JSON Patch format. Multiple operations can be provided and will be applied in order.

Parámetros de entrada

idstringObligatorio
The ID of the subscription to update.
operationsobject[]Obligatorio
Array of JSON Patch operations to apply to the subscription. Each operation is applied in order.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update web experience profile (partial)PAYPAL_PATCH_WEB_PROFILEAcción

Partially updates a PayPal web experience profile using JSON Patch (RFC 6902) operations. Use this action when you need to update specific fields of a web experience profile without replacing the entire resource. This action accepts an array of patch operations (add, remove, replace, move, copy, test) and applies them to the web experience profile. Common use cases include updating the profile name, presentation settings, flow configuration, or other fields. A successful update returns HTTP 204 No Content with no JSON response body. This action is idempotent - applying the same patch multiple times produces the same result.

Parámetros de entrada

idstringObligatorio
The unique web experience profile ID.
patchesobject[]Obligatorio
An array of JSON Patch operations to apply to the web experience profile. Each operation follows RFC 6902 format with 'op', 'path', and optionally 'value'.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Braintree PingPAYPAL_PING_BRAINTREEAcción

Sends a ping query to the PayPal Braintree GraphQL API. Use when you need to verify connectivity and authentication status with the Braintree GraphQL endpoint. Returns the literal string 'pong' on successful connection. This is a simple health check endpoint for verifying API connectivity. The ping operation does not modify any data and is idempotent.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Query Braintree ReportPAYPAL_QUERY_BRAINTREE_REPORTAcción

Queries Braintree reports via GraphQL API. Use this action when you need to retrieve reports from Braintree's GraphQL API, such as transaction reports, dispute reports, merchant funds availability, or transaction settlement outcomes. Each report type returns different data structures based on the specified report type and filter parameters. The report query provides access to various report types that can be queried with their own input parameters. This is a read-only operation that retrieves report data without modifying any records. Note: This action uses the Braintree GraphQL API endpoint at /graphql.

Parámetros de entrada

end_datestring
The end date for the report query in ISO 8601 format (e.g., '2024-01-31'). Used for time-based reports.
start_datestring
The start date for the report query in ISO 8601 format (e.g., '2024-01-01'). Used for time-based reports.
report_typestringObligatorioenum
The type of report to query. Each type has its own input parameters and response structure.
transactionReportdisputeReportmerchantFundsAvailabletransactionSettlementOutcomesReport
merchant_account_idstring
The merchant account ID to filter the report by. If not specified, uses the default merchant account.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Retrieve Payment ResourcePAYPAL_RETRIEVE_PAYMENT_RESOURCEAcción

Retrieve a PayPal payment resource by its ID. Use this action when you need to fetch details about an existing payment resource created through the Payment Links and Buttons API. This action is useful for checking payment resource status, viewing line items, or retrieving associated links after creating a payment resource. Note: Payment resources are shareable payment links used for simple payment flows.

Parámetros de entrada

payment_resource_idstringObligatorio
Unique identifier of the payment resource to retrieve. This ID is typically returned when creating a payment resource.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Search PayPal InvoicesPAYPAL_SEARCH_INVOICESAcción

Search for PayPal invoices based on various filter criteria. Use when you need to find invoices matching specific criteria such as status, date ranges, recipient information, amount ranges, or invoice numbers. This action supports pagination and can return total counts when total_required=true. **Common use cases:** - Find all invoices with a specific status (e.g., all DRAFT or SENT invoices) - Find invoices created within a date range - Find invoices for a specific customer by email or business name - Find invoices within a monetary amount range - Combine multiple filters for precise invoice searches **Pagination:** Results are paginated using page and page_size parameters. Set total_required=true to include total_counts in the response.

Parámetros de entrada

memostring
A private bookkeeping memo to filter by.
pageinteger
The page number to be retrieved. A combination of page=1 and page_size=20 returns the first 20 invoices. A combination of page=2 and page_size=20 returns the next 20 invoices.
fieldsstring[]
A list of fields to return for each invoice. Valid fields are: items, payments, refunds, additional_recipients_info, and attachments. Maximum 5 fields.
statusstring[]
An array of invoice status values to filter by. Common statuses include DRAFT, SENT, SCHEDULED, PAID, CANCELLED, REFUNDED, PARTIALLY_PAID, UNPAID.
archivedboolean
Indicates whether to list merchant-archived invoices. true: lists only archived, false: lists only unarchived, null: lists all.
page_sizeinteger
The maximum number of invoices to return in the response.
referencestring
The reference data including a Purchase Order (PO) number to filter by.
currency_codestring
The three-character ISO-4217 currency code to filter invoices.
due_date_rangeobject
The date range for filtering invoices.
invoice_numberstring
Filters the search by the invoice number.
total_requiredboolean
Indicates whether to show total_pages and total_items in the response.
recipient_emailstring
Filters the search by the recipient email address.
invoice_date_rangeobject
The date range for filtering invoices.
payment_date_rangeobject
The date and time range for filtering invoices.
total_amount_rangeobject
The amount range for filtering invoices.
creation_date_rangeobject
The date and time range for filtering invoices.
recipient_last_namestring
Filters the search by the recipient last name.
recipient_first_namestring
Filters the search by the recipient first name.
recipient_business_namestring
Filters the search by the recipient business name.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Simulate Webhook EventPAYPAL_SIMULATE_WEBHOOK_EVENTAcción

Simulates a webhook event to test your webhook integration. Use this action when you need to verify that your webhook endpoint is correctly configured and receiving events from PayPal. This is particularly useful during development and testing to ensure webhook handlers process events correctly without requiring real transaction data. Note: Either `url` or `webhook_id` must be provided in the request.

Parámetros de entrada

urlstring
The URL for the webhook endpoint. If omitted, the webhook ID is required.
event_typestringObligatorio
The event name. Specify one of the subscribed events. For each request, provide only one event.
webhook_idstring
The ID of the webhook. If omitted, the URL is required.
resource_versionstring
The identifier for event type (e.g., 1.0, 2.0).

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update DisputePAYPAL_UPDATE_DISPUTEAcción

Partially update a PayPal dispute using JSON Patch operations. Use when you need to modify specific fields of an existing dispute such as notes, status, or other patchable properties. This action applies partial updates to the dispute using RFC 6902 JSON Patch format. Multiple operations can be provided and will be applied in order. The API returns HTTP 202 (Accepted) on success.

Parámetros de entrada

dispute_idstringObligatorio
The ID of the dispute to update.
operationsobject[]Obligatorio
Array of JSON Patch operations to apply to the dispute. Each operation is applied in order.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Invoice (Full)PAYPAL_UPDATE_INVOICEAcción

Fully updates a PayPal invoice by replacing the entire invoice with the provided data. Use this action when you need to completely replace an invoice with new data. The invoice must be in DRAFT status to be fully updated. Note: This action sends optional notifications to both the recipient and the merchant by default. You can control this behavior using the send_to_recipient and send_to_invoicer parameters. This action is useful when you want to replace the entire invoice rather than making partial updates. For partial updates, use the UpdateInvoice action with PATCH semantics.

Parámetros de entrada

itemsobject[]
An array of invoice line item information. The maximum items for an invoice is 100.
amountobject
The invoice amount summary.
detailobjectObligatorio
The details of the invoice. Includes invoice number, date, payment terms, and audit metadata.
statusstringenum
The status of an invoice.
DRAFTSENTSCHEDULEDPAIDMARKED_AS_PAIDCANCELLEDREFUNDEDPARTIALLY_PAIDPARTIALLY_REFUNDEDMARKED_AS_REFUNDEDUNPAIDPAYMENT_PENDING+4
gratuityobject
The currency and amount for a financial transaction.
invoicerobject
The invoicer business information.
due_amountobject
The currency and amount for a financial transaction.
invoice_idstringObligatorio
The ID of the invoice to update.
configurationobject
The invoice configuration.
send_to_invoicerboolean
Indicates whether to send the invoice update notification to the merchant. Defaults to true.
send_to_recipientboolean
Indicates whether to send the invoice update notification to the recipient. Defaults to true.
primary_recipientsobject[]
The billing and shipping information. Includes name, email, address, phone, and language.
additional_recipientsstring[]
An array of one or more CC: emails to which notifications are sent.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update product (partial)PAYPAL_UPDATE_PAY_PAL_PRODUCTAcción

Partially updates a PayPal product using JSON Patch (RFC 6902) operations. Use this action when you need to update specific fields of a product without replacing the entire resource. This action accepts an array of patch operations (add, remove, replace, move, copy, test) and applies them to the product. Common use cases include updating the product name, description, or other fields. A successful update returns HTTP 204 No Content with no JSON response body. This action is idempotent - applying the same patch multiple times produces the same result.

Parámetros de entrada

patchesobject[]Obligatorio
An array of JSON Patch operations to apply to the product. Each operation follows RFC 6902 format with 'op', 'path', and optionally 'value'.
product_idstringObligatorio
The unique product ID.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update WebhookPAYPAL_UPDATE_PAY_PAL_WEBHOOKAcción

Updates a PayPal webhook using JSON Patch (RFC 6902) operations. Use this action when you need to modify specific fields of a webhook such as the URL or event types without replacing the entire resource. This action accepts an array of patch operations (add, remove, replace, move, copy, test) and applies them to the webhook. Common use cases include updating the webhook URL, adding or removing event type subscriptions, or modifying other webhook configuration. A successful update returns HTTP 200 OK with the updated webhook object. This action is idempotent - applying the same patch multiple times produces the same result.

Parámetros de entrada

patchesobject[]Obligatorio
An array of JSON Patch operations to apply to the webhook. Each operation follows RFC 6902 format with 'op', 'path', and optionally 'value'.
webhook_idstringObligatorio
The unique webhook ID.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update templatePAYPAL_UPDATE_TEMPLATESAcción

Fully updates a PayPal invoice template. Use this action when you need to completely replace an existing template with new values. Unlike partial updates, this replaces all fields of the template. The template_id path parameter must match the id in the request body. **Note:** This action replaces the entire template. Any fields not included in the request will be reset to their default values. **Required fields:** - template_id (path parameter): The ID of the template to update - id (request body): The template ID (must match the path parameter) - name (request body): The template name (must be unique) A successful update returns HTTP 200 OK with the updated template object. This action is idempotent - updating a template with the same values produces the same result without side effects.

Parámetros de entrada

idstringObligatorio
The ID of the template.
namestringObligatorio
The template name. Must be unique for the invoicer.
settingsobject
The template settings.
template_infoobject
The template details including invoicer business information, invoice recipients, items, and configuration.
unit_of_measurestringenum
The unit of measure for the invoiced item.
QUANTITYHOURSAMOUNT
default_templateboolean
Indicates whether this template is the default template. An invoicer can have only one default template.
standard_templateboolean
Indicates whether this template is a invoicer-created custom template. The system generates non-custom templates.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update web experience profilePAYPAL_UPDATE_WEB_PROFILEAcción

Updates a PayPal web experience profile. Use this action when you need to modify an existing web experience profile that controls the checkout flow appearance, branding, shipping options, and customer experience for PayPal payments. This action replaces the entire profile configuration with the provided values. A successful update returns HTTP 204 No Content with no JSON response body. This action is idempotent - updating a profile with the same values produces the same result without side effects.

Parámetros de entrada

idstringObligatorio
The ID of the web experience profile to update.
namestringObligatorio
The web experience profile name. Must be unique for a set of profiles for a merchant.
temporaryboolean
Indicates whether the profile persists for three hours or permanently. True for three hours, false for permanent.
flow_configobject
The flow configuration parameters for the web profile.
input_fieldsobject
The input field customization parameters for the web profile.
presentationobject
The style and presentation parameters for the web profile.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Verify Payment Method via BraintreePAYPAL_VERIFY_PAYMENT_METHODAcción

Verifies a multi-use payment method to ensure it has passed fraud rules and is associated with a valid account. Use this action when you need to verify that a vaulted (multi-use) payment method is valid before using it for transactions. The verification runs the payment method through your configured Braintree fraud rules and confirms with the card issuer that the card is associated with a valid account. This action is commonly used when a customer adds a new payment method and you want to validate it, when checking if a stored payment method is still valid before a scheduled transaction, or as part of a risk management workflow to pre-validate payment methods. The response includes a verification status (VERIFIED, FAILED, GATEWAY_REJECTED, or PROCESSOR_DECLINED) along with processor response codes. Note: This action uses the Braintree GraphQL API endpoint at /graphql. The payment method must be a multi-use token that has been stored in the Braintree vault.

Parámetros de entrada

inputobjectObligatorio
The input containing the payment method ID and optional merchant account ID for verification.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Verify Webhook SignaturePAYPAL_VERIFY_WEBHOOK_SIGNATUREAcción

Verifies the signature of a PayPal webhook notification to confirm its authenticity. Use this action when you receive a webhook notification from PayPal and need to verify that it was actually sent by PayPal and not tampered with during transmission. This is essential for security when processing webhook events like payments, disputes, or subscription changes. The required parameters (auth_algo, cert_url, transmission_id, transmission_sig, transmission_time, webhook_id, and webhook_event) are extracted from the webhook notification headers and body that PayPal sends to your endpoint.

Parámetros de entrada

cert_urlstringObligatorio
The X.509 public key certificate. Download the certificate from this URL and use it to verify the signature. Extract this value from the PAYPAL-CERT-URL response header, which is received with the webhook notification.
auth_algostringObligatorio
The algorithm that PayPal uses to generate the signature and that you can use to verify the signature. Extract this value from the PAYPAL-AUTH-ALGO response header, which is received with the webhook notification.
webhook_idstringObligatorio
The ID of the webhook as configured in your Developer Portal account.
webhook_eventobjectObligatorio
A webhook event notification.
transmission_idstringObligatorio
The ID of the HTTP transmission. Contained in the PAYPAL-TRANSMISSION-ID header of the notification message.
transmission_sigstringObligatorio
The PayPal-generated asymmetric signature. Appears in the PAYPAL-TRANSMISSION-SIG header of the notification message.
transmission_timestringObligatorio
The date and time of the HTTP transmission, in Internet date and time format. Appears in the PAYPAL-TRANSMISSION-TIME header of the notification message.

Parámetros de salida

dataanyObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not