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

Refer to our guide (steps 1 - 4) for more information on completing the necessary paperwork with Stripe/banks before integration.

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. You may also provide us with IP addresses to whitelist if necessary.

4. API keys

Provide our team with the relevant email addresses to receive an API key. Each API key is associated with a specific email address. 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.