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

• 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.
• Copy your location ID from the Locations tab of the Square Developer Dashboard to the LOCATION_ID field of the Heroku configuration page.
• 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 LOCATION_ID={{Replace_with_location_id}} node index.js