Solana Payments App

documentation | walkthroughs | installation | live store | merchant login

Transact on Shopify using Solana

Quickstart

Pre Setup Dependencies:

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