What is a Payment Instruction?
A Payment Instruction is a programmable payment agreement shared by a payer, payee, and guarantor. It captures the commercial promise, the evidence required to fulfill it, and the automated actions that release or refund funds. Everyone sees the same terms and same timeline.
Three parties, one shared truth
A Payment Instruction keeps the payer, payee, and guarantor aligned from authorization to settlement. Each party understands the expectations, evidence, and outcomes before any money moves.
Knows what they are paying for, how progress is tracked, and when funds are released.
Sees the agreed milestones and evidence so fulfillment neatly maps to payout events.
Enforces the rules precisely and executes releases or refunds when conditions are met.
The anatomy of a Payment Instruction
Inspired by the productized examples on MyOS, a Payment Instruction bundles the business promise, the execution plan, and the programmable guardrails that make conditional payments predictable.
Structured agreement
Capture the commercial terms that normally live in contracts or emails — services, deliverables, pricing, and completion signals — in a machine-readable format.
Evidence timeline
Define the checkpoints, documents, API callbacks, or human approvals that prove progress. The Payment Instruction records them as they happen, resolving ambiguity and disputes.
Programmable outcomes
Automate releases, refunds, or escalations. Once the guarantor observes the configured evidence, funds move instantly according to the plan.
Why teams adopt Payment Instructions
Payment Instructions originated in MyOS so banks, processors, and fintech platforms can make complex payouts feel as certain as card swipes. Conditional capture, escrow-like protection, and transparent dispute resolution become native capabilities instead of afterthoughts.
Programmable trust
Replace manual exception handling with rules that everyone agrees on before the transaction starts. The same blueprint can be issued again and again.
Cross-channel consistency
Whether you serve card, bank-transfer, or wallet flows, Payment Instructions keep data models aligned so stakeholders get one shared status page.
Faster commercialization
Package sophisticated payment experiences — subscriptions, marketplaces, on-demand payouts — as upgradeable products without rebuilding compliance every time.
For developers
The Payment Instruction format is defined in the Blue Language specification. You describe actors, states, evidence, and payouts declaratively, then deploy the definition to any execution environment that speaks the protocol. MyOS ships a reference implementation, and you can extend the same schema inside your own stack.
Read the Payment Instruction specMyOS Payment Instructions in action
MyOS includes prebuilt Payment Instructions for payouts, marketplaces, logistics, and more. Each template comes with dashboards for stakeholders, evidence capture flows, and automated fund movement. Explore a few highlights below.
Payment to Bob's Shop
$220.00
- Payer
- Alex Morgan
- Payee
- Bob's Shop
- Guarantor
- Your bank
Agreed conditions
Reserve $220. Release the payment when the shipping provider confirms delivery. Return the funds if delivery is not confirmed within 7 days.
Shared timeline
Payment authorized
The payer approved the amount and release conditions.
Funds reserved
Your bank reserved $220 for this purchase.
Delivery confirmed
The shipping provider recorded proof of delivery.
Funds released
$220 transferred to Bob's Shop.
View evidence
The shipping provider confirmed delivery. The bank recorded the matching settlement confirmation in the shared timeline.
Ready to craft your own Payment Instruction?
Partner with us to launch programmable agreements faster. We'll help design the commercial blueprint, wire it into your rails, and give your customers a shared source of truth.