# PayPal Setup

To integrate PayPal into HYS, we’ll require you to provide your Client ID, Secret and Webhook ID.

### Getting Client ID and Secret

The PayPal Client ID and Secret can be got from your PayPal developer platform. This will require that you first create a new App in PayPal incase you do not have one. Click "**Create App**" and follow the procedures.\
\
We have shared this resource from PayPal to help with creating of the app [https://developer.paypal.com/video/watch/?videoId=QTDEeB6xzCg](https://www.google.com/url?q=https://developer.paypal.com/video/watch/?videoId%3DQTDEeB6xzCg\&sa=D\&source=editors\&ust=1743077305190514\&usg=AOvVaw1802klgHyCDlivkoT_EKYg)

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2F4YIAhXTcShDFeTliecQ2%2Fimage.png?alt=media&#x26;token=bc09a8ba-5279-40dd-ab91-d9c9ba1105aa" alt=""><figcaption></figcaption></figure>

Once you have got the Client ID and secret, the next step is to create a Webhook so as to obtain a Webhook ID.

### Getting Webhook ID

After creating the app, you have to choose the one that you want to connect to HelpYouSponsor.\
Select the app that you want to use. You’ll be taken to that app page, scroll down to where you’ll find live Webhooks.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FWmRgSMmuQLNqkt78EgBA%2Fimage.png?alt=media&#x26;token=08b3a71c-5d73-4148-8ebe-d51b5319616c" alt=""><figcaption></figcaption></figure>

Click the "**Add Webhook**" button. You will be presented with a form to place the "**Webhook URL**".  Below is the URL to place there.

{% embed url="<https://api.helpyousponsor.com/v1/paypal/webhook>" %}

You can also get the Webhook URL from the PayPal payment integration in HelpYouSponsor.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FsA4M9o4aFAMXTdEXrAQc%2FScreenshot%202025-03-27%20at%202.27.47%E2%80%AFPM.png?alt=media&#x26;token=497f409e-f992-42df-a37a-933bb368b972" alt=""><figcaption></figcaption></figure>

After adding the webhook URL, go to the "**events type**" choose "**Payment Sale Completed**" under "**Payments & Payouts**" and then save.

Once saved, the page will appear as shown below showing the Webhook ID.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FOV4RxvPBLfsEFtz1c99n%2Fimage.png?alt=media&#x26;token=6386bfed-1f9b-4153-aebf-082b0a1575cf" alt=""><figcaption></figcaption></figure>

Then head over to HelpYouSponsor and click "**Payment Gateways**" under "**Settings**" on the main menu and then click the  "**Other Payment Gateways**" tab.\
\
Click "**View Integration**" for PayPal and add the Client ID, Secret and Webhook ID.

<figure><img src="https://3594793218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoKO2daI6MQ1KQOLltE3m%2Fuploads%2FaJsjYPZgPxW2tjKxDY10%2Fimage.png?alt=media&#x26;token=e9596e8f-6f98-4d45-9101-85fa41fad82f" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.helpyousponsor.com/guides/getting-started/quick-start-guide/payment-gateways/paypal-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
