Getting started

Introduction

HandCash Connect allows developers to embed payments into apps. That means the app doesn't need to interrupt the user experience to present a paywall.

The perfect payment system for industry disruptors 🚀

Make your first payment

First, users must connect their wallet to your app to grant permissions and provide you with an authToken.
This token allows you to access user profiles and make instant payments.

Follow the steps in this section to trigger your first payment using HandCash Connect.

Create your app in the dashboard

Create a HandCash Developer account: https://dashboard.handcash.io
Create a team.
Create an app.
Grab your appId and appSecret required by the SDK.
Define your redirection URLs. Users will be redirected there when they authorize your app.

Install the SDK

Install the Connect SDK for Node:

npm i @handcash/handcash-connect

Import the module and initialize using the appId and appSecret:

const { HandCashConnect } = require('@handcash/handcash-connect');
const handCashConnect = new HandCashConnect({ 
   appId: '<app-id>', 
   appSecret: '<secret>',
});

Redirect the user to HandCash to authorize your app

Generate the authorization URL and redirect the user to HandCash from your app.

const redirectionLoginUrl =  handCashConnect.getRedirectionUrl();

App authorization preview in the HandCash App

After the user has granted permissions to your app, they will be redirected to the authentication success URL you have set in the developer dashboard.

Initialize the user account

const account = handCashConnect.getAccountFromAuthToken(<authToken>);

Get the user profile

const { publicProfile } = await account.profile.getCurrentProfile();

console.log(`Hey $${publicProfile.handle}, welcome to my app!`);

Make a payment

const payParameters = {
      payments: [{ destination: 'handcashteam', currencyCode: 'USD', sendAmount: 0.10 }]
  };    
    
  await account.wallet.pay(payParameters);

Trigger your first payment

Open Recipe