$yieldfabric-ai>
▋

API Reference

Quick reference for endpoints, error codes, and common values

01

Base URLs

Auth Service:https://auth.yieldfabric.com
Payments Service:https://pay.yieldfabric.com
GraphQL Endpoint:https://pay.yieldfabric.com/graphql
02

Asset IDs

Asset IDDescription
aud-token-assetAustralian Dollars
usd-token-assetUS Dollars
03

Chain IDs

Chain IDNetwork
151Redbelly Mainnet (Governors)
153Redbelly Testnet (Governors)
04

Common Error Codes

401 UnauthorizedUNAUTHORIZED

Invalid or expired token

403 ForbiddenFORBIDDEN

Insufficient permissions

422 Validation ErrorVALIDATION_ERROR

Invalid input parameters

500 Server ErrorINTERNAL_ERROR

Internal server error

05

Status Values

Contract Status

ACTIVE
COMPLETED
PENDING
CANCELLED

Payment Status

COMPLETED
PROCESSING
PENDING
FAILED
06

Best Practices

Amount Format

Always use integer strings for amounts:

✓"100"Correct
✗"100.00"Incorrect
✗100Incorrect (not a string)

Timestamp Format

Use ISO 8601 format for dates:

✓"2025-11-01T00:00:00+00:00"
✓"2025-11-01"(simple date)

Idempotency Keys

Always use idempotency keys for mutations to prevent duplicate operations

07

Quick Links

Interactive API Explorer

Test API endpoints in your browser

Quick Start Guide

Get up and running in 5 minutes

Complete Workflows

End-to-end examples

GitHub

Sample code and SDKs

Previous
Cryptography