straitsx by hairyf/blockchain-master

Skill based on StraitsX Card Issuing API (v1-CARDS), generated 2026-02-25 from docs.straitsx.com.

StraitsX Card Issuing lets you launch and manage a payment card program: create users and cards, activate, enroll 3DS, set PIN, and handle authorizations and webhooks. CMS is REST (Bearer token); RHA and webhook are endpoints you implement and StraitsX calls.

Core References

Topic	Description	Reference
Overview	CMS vs RHA, hosts, when to use which	core-overview
Authentication	Bearer token, SSO token endpoint	core-authentication
Usage patterns	Node (npx api install + SDK) and Shell (curl), Base URL	core-usage-patterns
Getting started	Flow from user creation to activation and RHA/webhook	core-getting-started
Error responses	Error JSON format and error codes (4xx/5xx)	core-errors
Pagination & sorting	page[size], page[number], sort query params	core-pagination-sorting

Features

Card Management (CMS)

Topic	Description	Reference
Issuer Plan	Create, Update, Get Issuer Plan Card List	features-cms-issuer-plan
Card Product	Link Issuer Plan with Card Product, Get Card Product List, Create, BINs, Card Art	features-cms-card-product
User	Create, Update, Get User List / Detail / Card List	features-cms-user
Lifecycle	Create User, Create Card, Activate Card	features-cms-lifecycle
Card	Get Detail, Update Status, Close, Balance, Config, Printing, Token, Reissue	features-cms-card
Spend Limit	Create, Get, Update, Delete Card Spending Limit	features-cms-spend-limit
Transaction	Get Card/Issuer Transaction List, Get Detail, Get Total Amount	features-cms-transaction
OOB	Obtain out-of-band authentication	features-cms-oob
Accounting	Get Card Spending, Settlement/Spendable Balance, VISA FX Rates	features-cms-accounting
3DS	Enroll, Get Detail, Update, Unenroll 3DS for card number	features-cms-3ds
Iframe	PIN Setup/Reset/Change, Card, CVV iframe URLs	features-cms-iframe
Pin	PIN Setup, Reset, Change, Reset PIN Retry Counter (server-side)	features-cms-pin
Visa In-App Provisioning	Apple Pay, Google Pay in-app provisioning	features-cms-visa-in-app
Unassigned Card Batch Transfer	Create, Get All, Get Single batch transfer	features-cms-batch-transfer

Remote Host & Webhooks

Topic	Description	Reference
Remote Host Authorization & Webhook	RHA request/response, error codes; Webhook event types, signature, retry	features-rha-webhook
Transactions	Transaction types, auth vs webhook-only, balance updates	features-transactions
Transaction simulation	Staging-only simulator for testing RHA and webhook	features-transaction-simulation
Instant issuance & OOB	Instant card pool, OOB 3DS flow	features-instant-issuance-oob

Best practices

Topic	Description	Reference
Rejection and rate limit	rejection_reason codes, 429 handling and limits	best-practices-rejection-rate-limit

API Reference (by endpoint)

Request/response and curl examples for CMS and RHA/Webhook are in the references below. Call patterns (Node SDK / curl): core-usage-patterns.

Module	Content	Reference
Remote Host Authorization	Your RHA endpoint: request body, approve/reject response, error codes	features-rha-webhook
Webhook Notification	Event types, signature verification, retry policy	features-rha-webhook
Issuer Plan	Create, Update, Get Issuer Plan Card List	features-cms-issuer-plan
Card Product	Link, Get Card Product List, Create, Get Merchant BINs, Card Art List	features-cms-card-product
User	Create, Update, Get User List / Detail / Card List	features-cms-user
Card (lifecycle)	Create User, Create Card, Activate Card	features-cms-lifecycle
Card (operations)	Get Detail, Update Status, Close, Balance, Config, Printing, Token, Reissue	features-cms-card
Spend Limit	Create, Get, Update, Delete Card Spending Limit	features-cms-spend-limit
Transaction	Get Card/Issuer Transaction List, Detail, Total Amount	features-cms-transaction
OOB	Obtain out-of-band authentication	features-cms-oob
Accounting	Get Card Spending, Settlement/Spendable Balance, VISA FX Rates	features-cms-accounting
3DS	Enroll, Get Detail, Update, Unenroll 3DS	features-cms-3ds
Iframe	PIN Setup/Reset/Change, Card, CVV iframe URLs	features-cms-iframe
Pin	PIN Setup, Reset, Change, Reset PIN Retry Counter	features-cms-pin
Visa In-App Provisioning	Apple Pay, Google Pay provisioning	features-cms-visa-in-app
Transaction Simulation	Staging-only simulate transactions	features-transaction-simulation
Unassigned Card Batch Transfer	Create, Get All, Get Single batch	features-cms-batch-transfer

More detail: Official API Reference.