Connect Your Stripe Account

If you have a current Stripe Account, the first step to do is to connect it to PosiPay. In PosiPay, a Gateway Account record holds the authenticated credentials of a merchant account from a certain gateway service provider. This is necessary for initiating payment processing, tokenizing Credit Card/Bank Account details, generating invoices, refunding a payment, and settlement reconciliation.

The steps below will guide you on creating and authenticating a Gateway Account record.
Note: If you have multiple Stripe Accounts, create a separate Gateway Account record for each of them.

Create a Gateway Account Record

Follow the steps on how to create a Gateway Account record:

1. Click the App Launcher and search for Gateway Accounts.

   

2. Go to the Gateway Accounts tab.

3. Click New.

4. In the New Gateway Account modal,

   1. Provide the following details to the Information section:

      1. Provide your desired Gateway Account Name.

      2. Select Stripe as the Gateway Provider. Take note that PosiPay only supports Stripe.

      3. Populate the API Token with the Secret Key of your Stripe account.

      4. Populate the Publishable Key with the Publishable Key of your Stripe account.

      5. Set v1 as the API Version.

      6. How to populate Base URL on Gateway Account

         • Go to Setup and search All Sites on Quick Find

         • Copy the URL of the site that is accessible by Guest users (the one you created in the last step)

         • Once copied, paste the URL on the base URL of the Gateway Account

         • When the gateway account is being saved, the Webhook Endpoint URL will auto-populate

      7. Make sure that the Active checkbox is disabled at this stage. The Gateway Account record will be activated once authenticated.

      8. If your Stripe account is in test mode, enable the Sandbox checkbox. Otherwise, disable the Sandbox checkbox.

      9. If your Stripe account is enrolled in 3D Secure Payments, enable the Enable 3D Secure checkbox. Otherwise, disable the Enable 3D Secure checkbox.

      10. Select the supported currencies of your Stripe account in Accepted Currency.

      11. Select a Default Currency.
          

          

   2. Provide the following details to the Payment Method section:

      1. Select a Payment Method. Take note that PosiPay only supports Card and Bank Debit for now.

      2. Select the supported card types of your Stripe account in Accepted Card.

      3. You can set a brief Description of your Gateway Account record.

         

5. Click Save or Save & New to save your new Gateway Account record.

How to authenticate your Gateway Account record

Follow the steps on how to authenticate your created/updated Gateway Account record:

1. In your Gateway Account record, click Gateway Account Authentication.

   

2. After clicking the Gateway Account Authentication, a notification message will appear:

   1. If your Stripe credentials stored in the Gateway Account record are valid:

      1. A successful message will be displayed.

         

      2. The Active checkbox is enabled and the credentials will be cleared out.

         

   2. If your Stripe credentials stored in the Gateway Account record are invalid:

      1. An error message will appear.

         

      2. The Active checkbox is still disabled and the credentials are not cleared out.

         

Once you have authenticated your Stripe account on the PosiPay end, it is time to connect the webhooks on the Stripe end.

Next place to go: Stripe Webhook Set up