easyCards Developers
中文 Website
EASYCARDS VCC API

Build card issuing into your product.
Clear, reliable, and verifiable.

From creating cardholders and submitting card applications to top-ups, shared-card withdrawals, transaction queries, and Webhook reconciliation. Follow the real business sequence and look up every VCC endpoint in the API Reference.

Read the VCC integration guide → Browse API Reference
Sandbox available OpenAPI 3.0 Bearer Token
create-card-application.sh 
curl --request POST \
  --url https://sandbox.easycards.io/payment/vcc/card-applications \
  --header 'Authorization: Bearer $API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "request_id": "req_20260806_001",
    "customer_id": "cus_example",
    "product_code": "1103"
  }'

# Response: asynchronous request accepted
{
  "code": "SUCCESS",
  "data": {
    "application_id": "app_example",
    "status": "PENDING"
  }
}
DOCUMENTATION

Start in the way that works for you

Read the complete workflow, look up an endpoint directly, or download the contract for your existing tools.

P

Merchant Portal Guide

Follow the current Portal workflow for business onboarding, treasury accounts, team invitations, shared cards, stored-value cards, top-up approvals, and system settings.

Open the Portal guide
H5

Cardholder H5 Guide

For invited cardholders: activate an account, use TOTP, complete personal KYC, view cards, request top-ups, review transactions, and manage profile settings.

Open the H5 guide
01

VCC Integration Guide

Covers authentication, products, cardholders, KYC, card issuance, sensitive card data, top-ups, shared-card withdrawals, transactions, and Webhooks.

Integrate step by step
</>

API Reference

An OpenAPI-generated reference for VCC and supporting account endpoints, with search, field documentation, and Sandbox request examples.

View all endpoints
→

Core Business Flows

Use sequence diagrams to understand VCC product discovery, cardholders, card issuance, KYC, Webhooks, and query-based reconciliation.

View flow diagrams
QUICK START

Get it working, then expand

Start in the Sandbox to validate authentication, permissions, and account scope before implementing the complete VCC flow.

1

Get an API Key

Create a least-privilege Payment API Key and store it securely.

2

Verify the account and permissions

Call GET /payment/account to confirm authentication, allowlisting, and account scope.

3

Query live product configuration

Call GET /payment/vcc/products; never hard-code products or fees.

4

Confirm the asynchronous terminal state

Store resource IDs and use Webhooks plus query endpoints for idempotent processing and reconciliation.

DOWNLOADS

Developer tool files

Every file is built from the same API contract, reducing drift between the guide, testing tools, and the live API.

VCC OpenAPI / Swagger

OpenAPI 3.0 JSON for VCC and supporting account queries, suitable for code generation, testing, and documentation tools.

Download specification
JSON

VCC Postman Collection

VCC and supporting account-query collection with authentication, parameters, and request body examples.

Download collection
POSTMAN

Sandbox Environment

Sandbox Base URL and secure Token variable template.

Download environment
ENV

Live Environment

Production environment variable template; verify permissions and allowlisting before launch.

Download environment
ENV