Get started

This documentation provides a step-by-step guide to help government and public sector organizations seamlessly integrate PaySG with their systems/e-services.

1. Introduction

Ensure that the onboarding steps in this section have been completed.

The rest of this guide walks you through setting up your integration with PaySG.

2. Create a payment service

To begin, follow our payment service guide and create a payment service on our testing environment (staging.pay.gov.sg). All .gov.sg email addresses can do so without needing to create an account.

3. Whitelisting

If you are a vendor, please contact us at [e-mail] to whitelist your email addresses for access to our staging environment. You may also provide us with IP addresses to whitelist if necessary.

4. API keys

Provide our team with the relevant gov.sg email addresses to receive an API key. This email address must have been used to log in to PaySG's staging (test) environment or live environment before, so that it is associated with a user.

Staging API keys have the prefix paysg_stag_ while the live API keys have the prefix paysg_live_. Payments should be tested on the staging environment using dummy credit card numbers.

To make authenticated requests, provide an x-api-key: <key> header to the request.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

5. Test out our endpoints

Refer to our documentation on endpoints to send your first request.