PayStablecoin Merchant API - Integration Guide

Overview

PayStablecoin Merchant API uses HMAC-SHA256 signature authentication to ensure the security and integrity of requests. This guide explains how to integrate our API using Postman, Java, or Python.

Environments

Environment	API Base URL	Merchant Portal
Sandbox	https://api.sandbox.paystablecoin.global	https://merchant.sandbox.paystablecoin.global
Production	https://api.paystablecoin.global	https://merchant.paystablecoin.global

Use the Sandbox environment for development and testing. Switch to Production when you are ready to go live.

---

Prerequisites

Before you begin integrating with the PayStablecoin Merchant API, ensure you have completed the following:

1. Merchant Account Registration

• Register for a merchant account at the Merchant Portal (Sandbox or Production)
• Complete any required verification processes

2. Save Your Merchant ID

• During registration, you will be assigned a Merchant ID (e.g., 1000)
• Save this value immediately - you'll need it for all API requests
• If lost, contact business support to recover it

3. Retrieve Your API Credentials

Once logged into the merchant portal:

1. Navigate to API Settings in the navbar
2. Copy and securely store your credentials:
   • API Key (e.g., PSTG6ELOB2YXKO4ZHRQ6NKTSBY)
   • API Secret (e.g., MpkvVlXvYTZVPPJ0LReNA-g_yC7V7foe4UAj7tgWJSM)

SECURITY REMINDER

• Never commit your API Secret to version control
• Store credentials in environment variables or a secure vault
• Contact support immediately if credentials are compromised

4. Prepare Your Integration Environment

• Ensure your server clock is synchronized (NTP recommended)
• Prepare HTTPS endpoints for webhooks (if using callbacks)
• Have a test transaction flow ready

Ready to start? Continue with the Quick Start guide below.

---

Quick Start

Download SDK Examples

Get ready-to-use code examples for Java and Python:

📦 Download SDK Examples (ZIP Archive)

The package includes:

• Java - Maven project with complete StablePayClient implementation
• Python - pip-installable SDK with examples

After downloading, extract and follow the README in each language folder.

Integration Steps

1. Read Authentication Headers to learn how to set up request headers
2. Learn Signature Algorithm to master signature calculation
3. Check Important Notes to avoid common mistakes
4. Choose your integration method:
   • Postman Integration - Quick API testing
   • Java Integration - Java application integration
   • Python Integration - Python application integration

Next Steps

• View API Reference to learn about all available endpoints
• Set up Webhook Notifications to receive real-time payment updates
• Read Error Codes and Solutions to understand response codes and troubleshoot issues
• Follow Security Best Practices to ensure secure integration

Languages

• English - English documentation (current)
• 繁體中文 – Traditional Chinese documentation