Online Checkout TypeScript SDK

Accept card payments server-side with full TypeScript support!

The myPOS Online Checkout TypeScript SDK (mypos-online-checkout) is a server-side package for Node.js that integrates with the myPOS IPC (Integrated Payment Checkout) platform. It handles request signing, hosted-page redirects, webhook validation, card tokenization, and transaction management — all from your backend.

Server-side only: All cryptographic operations use your private credentials. Never import or run this package in a browser or client-side bundle.

Features

Purchase & hosted checkout
Card tokenization
Direct card charging (stored tokens)
Transaction status queries
Refunds & reversals
Pre-authorization & fund transfers
Optional React sub-export
Full TypeScript definitions

Requirements

Node.js 18+

Uses native fetch and modern ESM/CJS dual build.

Active myPOS Merchant Account

Required to obtain API credentials and access the merchant portal.

Merchant Portal Credentials

IPC credentials (Store ID, Secret key, Key index, Store password) from your merchant portal.

Server-side Runtime Only

Never expose credentials in the browser. Always run on your server or in an API route.

Installation

npm install mypos-online-checkout

The package ships as an ESM/CJS dual build with full TypeScript definitions — no extra @types package needed.

React Sub-export

An optional React integration is available under a separate entry point:

import { PaymentForm, usePaymentForm } from 'mypos-online-checkout/react'

This keeps the core server-side package free of React dependencies. See React integration for a complete example.

Continue Reading