Skip to main content

Rich markdown guide

SfeyDocs uses Docusaurus for guides—the same narrative layer Stoplight provides alongside API reference.

Admonitions

tip

Use Try It on the demo API explorer after npm run start:all is running.

warning

TPS test APIs (pg.test.sfey.com) are reached via the sandbox-proxy sidecar route (POST /api/try-it/proxy), not direct browser fetch. You must be logged in to SfeyDocs (Silo 9 session). Local dev may still be blocked by the test LB IP allowlist unless you are on VPN or the NAT GW is whitelisted.

info

Legacy Stoplight exports may include stoplight-id frontmatter and HTML in OpenAPI descriptions; the demo spec is clean YAML for Swagger UI.

Tables

FieldTypeRequired
amount_centsintegeryes
currencystring (ISO 4217)yes
merchant_refstringno

Code samples

curl -s http://127.0.0.1:4010/health
{
"payment_id": "pay_demo_7f3a2b",
"status": "authorized",
"amount_cents": 1250,
"currency": "EUR"
}