Solana Payments App

documentation  |  walkthroughs  |  installation  |  live store  |  merchant login

Transact on Shopify using Solana

Quickstart

Pre Setup Dependencies:

• Docker Desktop
• MySql

Installation:

git clone https://github.com/solana-labs/solana-payments-app
yarn install
yarn setup:env

In apps/backend-serverless/.env.dev, add a Keypair secret for a wallet with SOL to pay for gas In apps/backend-serverless/.env.dev, setup a Helius API key

To run:

yarn dev
yarn seed

Testing

Use these links to test out the local development flow

Local Merchant Portal

Local Payment Simulation

** Note **

These links redirect you to the frontend local deployments. We included sample development certificates in backend-serverless and mock-shopify-serverless, however, you might need to ignore browser errors. Follow this guide to setup your own local dev certificates

For various helper scripts you might need while extending the code, in apps/backend-serverless, you can run

node --loader ts-node/esm scripts/nft-setup.ts

Deploying

We use the Serverless Framework, follow their directions to setup your appropriate aws & serverless credentials.

Ensure you setup the following dependencies in the respective .env files

• Sentry for logging
• TRM for scanning for suspicious wallets
• Helius for Solana rpc
• Coingecko for price data
• Persona for kyb
• Planetscale (recommended) or any mysql database provider
• AWS Lambda for Serverless deployment
• Vercel for frontend hosting

In apps/backend-serverless, deploy with

yarn deploy:production:purple
yarn deploy:production:green

In apps/transaction-request-serverless, deploy with

yarn deploy:production

(change production to staging for a staging environment)

Make sure to use more secure JWTs in the .envs when deploying to staging and production