Members
This document outlines the process flow for member management, including creation, linking to an Identity Provider (IDP), and enabling transactions.
Introduction
Welcome to the technical guide on handling members in KamioKash. This document outlines the process flow for member management, including creation, linking to an Identity Provider (IDP), and enabling transactions.
Wallets and Transactions are an opt-in feature that allows flexibility in creating your program, orders and bookings can be created without using wallets and transactions.
flowchart LR
signUp("`User Sign Up`")
newMember("`User captures profile details`")
walletCheck[[Use profile reference to create or check if wallet exists]]
subgraph Client Site
signUp
end
subgraph KamioKash
signUp --> newMember --> walletCheck
endMember Creation
To start, members must be created through our API. This involves providing basic information such as name, email, and an external ID.
POST /api/members
{
"name": "John Doe",
"email": "john.doe@example.com",
"externalID": "unique-external-id",
"idp": "[YOUR IDP]",
"userId": "[Your IDP user ID]"
}The external ID unique-external-id will be used a reference for this member thought the system when creating Orders and Wallets, we also store Idp references for use on your backend server to handle easy reference to your user IDs
Enabling Transactions
With the member created and authenticated, they're now ready to initiate transactions. This includes creating orders, managing wallets, and linking to bookings.
Creating a Wallet
Each member needs a wallet to manage their transactions.
POST /api/wallets
{
"owner": "unique-external-id"
"externalId": "wallet_123",
"name": "string",
}Getting Started
This guide is designed to help you take the first steps toward integrating our powerful Wallets and Rewards APIs into your applications.
Communications
KamioKash's Dynamic Communications system enables automatic sending of personalized messages through email and SMS, triggered by specific system events.