# Payspace - Payroll Connector setup

The following steps describe the Payroll Connector setup.

Login and navigate to **Setup and Configuration > Ruleset Setup**. Select the ruleset for which thew Payroll connector needs to to be configured.

[![image.png](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/scaled-1680-/nyxx1FdNAC5qkBg2-image.png)](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/nyxx1FdNAC5qkBg2-image.png)

After selecting the ruleset:  
[![image.png](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/scaled-1680-/ztNBWrEJmu29Mrcf-image.png)](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/ztNBWrEJmu29Mrcf-image.png)

1. Select **Integrations**
2. Select **Payroll** and click **+ Payroll Connector**
3. Choose between **Push to Payroll** or **Pull from Payroll**
4. Enter **Name** - a descriptive name to distinhguish the connector
5. Enter **Client ID**
6. And **Client Secret**- this is obtained from Payspace  
    > Login to Payspace @ [https://identity.yourhcm.com/account/login](https://identity.yourhcm.com/account/login)  
    > Go to **Config menu | Company settings | General Company | Integration | API Credentials** [![image.png](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/scaled-1680-/GmOSFzYLGknUKEZ6-image.png)](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/GmOSFzYLGknUKEZ6-image.png)
    
      
    > Click + to add a new API credential  
    > Enter the **Name**, leave **Client Id** on *Autogenerated*, select **User** to impersonate (if needed) and leave **Scope** on *Read-only accees* and click on **Save**.  
    [![image.png](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/scaled-1680-/AfJYYWcvZ3k86I1w-image.png)](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/AfJYYWcvZ3k86I1w-image.png)
    
    Copy the **New Client Id** and **New Client Secret** to the **Client ID** and **Client Secret** field on Signify  
    [![image.png](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/scaled-1680-/PvhLmQR7xaz3W5Gv-image.png)](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/PvhLmQR7xaz3W5Gv-image.png)
7. **Base URL** - see below  
    <table border="0" cellpadding="0" cellspacing="0" id="bkmrk-production-testing-h" style="border-collapse: collapse; width: 396px;" width="528"><colgroup><col span="2" style="mso-width-source: userset; mso-width-alt: 9654; width: 198pt;" width="264"></col> </colgroup><tbody><tr style="height: 15.0pt;"><td height="20" style="height: 15.0pt; width: 198pt;" width="264">**Production**</td><td style="width: 198pt;" width="264">**Testing**</td></tr><tr style="height: 15.0pt;"><td class="xl65" height="20" style="height: 15.0pt;"><span style="font-variant-ligatures: normal; font-variant-caps: normal; orphans: 2; widows: 2; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">https://api.payspace.com/odata</span></td><td class="xl65"><span style="font-variant-ligatures: normal; font-variant-caps: normal; orphans: 2; widows: 2; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">https://apistaging.payspace.com/odata</span></td></tr></tbody></table>
8. **Authentication URL** - see below  
    <table border="0" cellpadding="0" cellspacing="0" id="bkmrk-production-testing-h-1" style="border-collapse: collapse; width: 396px; height: 59.2px;" width="528"><colgroup><col span="2" style="mso-width-source: userset; mso-width-alt: 9654; width: 198pt;" width="264"></col> </colgroup><tbody><tr style="height: 29.6px;"><td height="20" style="height: 29.6px; width: 198pt;" width="264">**Production**</td><td style="width: 198pt; height: 29.6px;" width="264">**Testing**</td></tr><tr style="height: 29.6px;"><td class="xl65" height="20" style="height: 29.6px;"><span style="font-variant-ligatures: normal; font-variant-caps: normal; orphans: 2; widows: 2; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">https://identity.yourhcm.com</span></td><td class="xl65" style="height: 29.6px;"><span style="font-variant-ligatures: normal; font-variant-caps: normal; orphans: 2; widows: 2; -webkit-text-stroke-width: 0px; text-decoration-thickness: initial; text-decoration-style: initial; text-decoration-color: initial;">https://staging-identity.yourhcm.com</span></td></tr></tbody></table>
9. **Company ID** - obtained from Payspace  
    Go to **Config menu | Basic Settings | Company settings | Basic Company Information | Company code**  
    [![image.png](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/scaled-1680-/gC7gPcQUAjlOpZAk-image.png)](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/gC7gPcQUAjlOpZAk-image.png)
    
      
      
      
    [![image.png](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/scaled-1680-/wMkg4kKxNGCgfzMo-image.png)](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/wMkg4kKxNGCgfzMo-image.png)
10. Finally, click on **Save.   
    NOTE:** During the **Save** action, the connection to Payspace will be tested and if saved successfully, means the credentials supplied are correct.  
    When not successful, you will be notified and the credentials, especially the Client ID, Client Secret and Company ID need to be verified carefully before trying to **Save** again.  
    [![image.png](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/scaled-1680-/15p9YABQ6em5uUoK-image.png)](https://signature.signifyhr.co.za/uploads/images/gallery/2024-07/15p9YABQ6em5uUoK-image.png)