Integration Guides

Integrate POST Token

Step-by-step guides to help you integrate POST Token into your business, whether you're a merchant, postal operator, or developer.

For Merchants

Accept POST payments at your business with low fees and instant settlement.

QR Code payments
E-commerce plugins
POS integration

View Guide

For Postal Operators

Integrate POST Token for real-time settlements and cross-border transfers.

Settlement API
Transaction-Linked Conversion
Vesting management

View Guide

For Developers

Build applications on POST Token with our comprehensive API.

RESTful API
SDK libraries
Sandbox environment

View Guide

Merchant Integration Guide

Accept POST payments at your business

QR Code Payment Flow

Generate QR Code

Create a unique QR code for each transaction with amount and merchant ID

Customer Scans

Customer opens POST Wallet app and scans the QR code

Confirm Payment

Customer confirms payment amount and authorizes transaction

Instant Settlement

Payment settles in under 2 seconds. Notification sent to both parties.

Setup Time

Less than 1 hour

Perfect for retail, restaurants, pop-up shops, and events

Generate QR Code

// Generate payment QR code
const qrData = {
  merchantId: "MERCH_ABC123",
  amount: 25.99,
  currency: "USD",
  reference: "ORDER-12345"
};
 
const qrCode = await postSdk.generatePaymentQR(qrData);
// Display qrCode.imageUrl to customer

Supported Platforms

Shopify
Install POST Payments app from Shopify App Store
WooCommerce
Download POST Gateway plugin for WordPress
Custom Integration
Use our Payment Gateway API for custom platforms

Setup Time

2-4 hours

E-Commerce Integration

// Initialize payment
const payment = await postGateway.createPayment({
  amount: 99.99,
  currency: "USD",
  orderId: "ORD-123456",
  returnUrl: "https://yourstore.com/success",
  cancelUrl: "https://yourstore.com/cancel"
});
 
// Redirect customer to payment.checkoutUrl

POS terminal integration requires partnership setup. Contact our sales team to get started.

Supported POS Systems

Square Terminal
Toast POS
Clover
Custom integrations available

Setup Time

1-2 weeks

Includes technical assessment, integration development, testing, and training. Best for multi-location retailers and franchises.

Postal Operator Integration Guide

Real-time settlements and cross-border transfers

Operator Authentication Required

Postal operator integration requires UPU verification and operator credentials. Contact partnerships@postnetwork.io to begin the onboarding process.

Integration Timeline

Week 1: Technical Assessment

POST team evaluates infrastructure and creates integration roadmap

Weeks 2-6: Development

API integration into existing postal systems with POST developer support

Weeks 7-8: Testing

Comprehensive UAT, security audit, and documentation

Week 9+: Go Live

Production activation with 24/7 support monitoring

Key Integration Points

Transaction API
Create transactions for money transfers, shipments, terminal dues
Gateway API
POST ↔ PSDR conversion with transaction-linked minting
Vesting API
Manage country airdrop allocations and controlled release
Settlement Reports
Automated reconciliation and reporting

Transaction-Linked Conversion Flow

JavaScript

// 1. Create transaction
const txn = await postApi.transactions.create({
  type: "MoneyTransfer",
  amount: 100,
  currency: "USD",
  operatorCode: "USPS"
});
 
// 2. Swap POST to PSDR (requires txn.transactionId)
const swap = await postApi.gateway.swap({
  postAmount: 40.816,
  transactionId: txn.transactionId,
  transactionType: "MoneyTransfer"
});

Developer Quickstart

Build applications on POST Token

1. Get API Credentials

JavaScript

// Your API credentials
const API_KEY = "pk_test_xxxxx";
const API_SECRET = "sk_test_xxxxx";
 
// Base URL
const BASE_URL = "https://api.staging.post.network";

2. Install SDK

Bash

# npm
npm install @post-token/sdk
 
# yarn
yarn add @post-token/sdk
 
# pnpm
pnpm add @post-token/sdk

3. Initialize Client

TypeScript

import { PostNetwork } from '@post-token/sdk';
 
const post = new PostNetwork({
  apiKey: process.env.POST_API_KEY,
  environment: 'sandbox' // or 'production'
});
 
// Test connection
const rates = await post.gateway.getRate();
console.log('POST/USD:', rates.postToUsd);

4. Make Your First API Call

TypeScript

// Calculate transfer cost
const calculation = await post.calculator.transfer({
  amount: 100,
  currency: 'USD',
  originCountry: 'US',
  destinationCountry: 'PH'
});
 
console.log('Fees:', calculation.totalFees);
console.log('Recipient gets:', calculation.recipient.amount);

Available SDKs

JavaScript/TypeScript

Available

Python

Available

Java

Coming Soon

Ruby

Coming Soon

PHP

Coming Soon

View Full API Documentation