In-App Payments Server Quickstart

This is an example server with a single endpoint of /chargeForCookie for processing payments using Square. The server expects a POST request with a payload of application/json following the format:

{
  "nonce": "INSERT_YOUR_NONCE_HERE"
}

Please replace "INSERT_YOUR_NONCE_HERE" with your own nonce that was generated from either the Square Payment Form or the In-App Payments SDK.

Instructions

Deploy to Heroku

  • Click the Deploy to Heroku button
  • Login or create a Heroku account
  • Enter a unique Heroku app name.
  • Go to the Square Application Dashboard and select your application.
  • Copy the Personal Access Token from the Credentials tab into the ACCESS_TOKEN field of the Heroku configuration page.
  • Specify the environment by setting ENVIRONMENT. Sandbox use - SANDBOX; Production use - PRODUCTION.
  • Click Deploy app
  • Copy https://[Heroku app name].herokuapp.com/chargeForCookie as your URL to POST to in your mobile application.

Example curl request you can make to the server:

curl -X POST 'https://[Heroku app name].herokuapp.com/chargeForCookie' \
  -H 'Content-Type: application/json' \
  -d '{ "nonce": "INSERT_YOUR_NONCE_HERE" }'

You can find the test nonce values in the guide Sandbox Test Values.

Start localhost server

  • Go to the Square Application Dashboard and select your application.

  • Copy the Personal Access Token from the Credentials tab into the ACCESS_TOKEN field of the Heroku configuration page.

  • Specify the environment by setting ENVIRONMENT. Sandbox use - SANDBOX; Production use - PRODUCTION.

  • Run the following command in the root folder of this project:

    PORT=8000 ACCESS_TOKEN={{Replace_with_personal_access_token}} ENVIRONMENT=SANDBOX node index.js