Quickstart
From app credentials to first query / Access Key
Prerequisites
- An app with
app_idand an app RSA private key - Merchant/store openApp’d to that app (otherwise admin may return
E02503) - Base URL, e.g.
https://api.9xnetwork.com
Path A — morph 1 only
- Build an
order.query(or any authorized method) - Compute RSA2
signper Authentication POST /api/entry- Check the envelope:
code === "0"or a clear business error (not a signature failure)
Confirms entry + app signing.
Path B — payments with Access Key
access.key.createwithscope_id=payments.read_write; storekey_id+secret- Optionally create a
payments.refundmanager - Ensure Access Key force is enabled for the app (platform config)
- Call
order.querywith both appsignand Access Keykey_sign - Refund with manager; clerk refund should yield
E07315
Path C — tool-assisted
Use this repo’s Apifox collection if you prefer not to script signing yet: admin cases cover create/list/rotate/revoke; morph-2 cases cover missing key, bad HMAC, wrong store, scope denial, etc.
Next
- Fields & JSON examples: API Reference
- Scope & rotation: Access Key