The product
What is Stableyard?
What is Stableyard?
Who is it for?
Who is it for?
Do my customers sign up with Stableyard?
Do my customers sign up with Stableyard?
Can a business hold an account?
Can a business hold an account?
subjectType: "business". With no verification, it can collect and send stablecoin, hold a handle and deposit addresses, and appear under its own name at checkout.After hosted business verification, it can also link its own US bank, hold a USD on-ramp account and pay out to that bank. One-time bank and QR payouts to a third party are for individual accounts only. subjectType cannot be changed after creation.See Business verification.Access and environments
How do I get access?
How do I get access?
How long does onboarding take, and what does it cost?
How long does onboarding take, and what does it cost?
GET /v2/partners/config.See Assessing fees.Is there a sandbox?
Is there a sandbox?
https://staging-api-v2.stableyard.fi and production is at https://prod-api.stableyard.fi. Sandbox uses the same API, states and verification rules as production, with test networks and no real money.The two are provisioned separately. Credentials, accounts, webhook endpoints and enabled capabilities do not carry across. See Environments.How do I know what my app can do?
How do I know what my app can do?
GET /v2/partners/config with your credential. It reports your organization’s KYB status and the products, networks, assets and payment methods available to your app in that environment. Read it at startup rather than hardcoding it, because what is enabled for you can change.See Capabilities and Get configuration.Coverage
What is limited or not available?
What is limited or not available?
Where does it work?
Where does it work?
Do you support cards?
Do you support cards?
Money
How do fees work, and how do I earn?
How do fees work, and how do I earn?
fees in GET /v2/partners/config. See Assessing fees.Who absorbs the fee?
Who absorbs the fee?
Who holds the money?
Who holds the money?
Can I show my customer a balance?
Can I show my customer a balance?
GET /v2/accounts/{accountId}/balances is a reporting view of recorded activity, marked custodyScope: "not_a_custody_balance". It can be negative and is not a live read of any wallet. Never authorize a payout against it.If your product shows a spendable balance, keep that ledger yourself. See Transactions.When something goes wrong
What happens if a payer sends too little?
What happens if a payer sends too little?
What if a payer pays twice, or after the payment expired?
What if a payer pays twice, or after the payment expired?
incidentRecoverySummary on the payment, separate from refundSummary, so a returned duplicate never makes a fulfilled order look refunded. See Reconciliation.Can a retry charge my customer twice?
Can a retry charge my customer twice?
Idempotency-Key. The same key with the same request returns the original result. The same key with a changed request is refused.After a timeout, read the payment or retry with the same key. Never create a replacement payment for a stuck one. See Idempotency.What happens when a payout fails?
What happens when a payout fails?
How quickly is a held payment resolved?
How quickly is a held payment resolved?
operationalState: "requires_intervention" and an operationalReasonCode. Put it in a queue with a named owner on your side, and contact Stableyard.See Error handling.Compliance and identity
Do I have to verify my customers?
Do I have to verify my customers?
individual, hosted business verification for a business. Each bank capability is then activated per account. See Onboarding overview.Do we store identity documents or bank account numbers?
Do we store identity documents or bank account numbers?
Building it
What do I build, and what does Stableyard provide?
What do I build, and what does Stableyard provide?
Do I need a frontend integration?
Do I need a frontend integration?
How do I test?
How do I test?
Is a webhook enough to mark an order paid?
Is a webhook enough to mark an order paid?
accepted means the payer’s funds were verified, and succeeded means the recipient’s destination was credited. See Webhooks and Reconciliation.Can I use an AI coding assistant?
Can I use an AI coding assistant?
GET /v2/partners/config, to send an Idempotency-Key on every money-moving create, and to keep the app secret on your backend.