Smart Contracts in Action

See how POST smart contracts convert volatile POST to stable PSDR, lock funds in escrow, and settle transactions automatically across postal packages, money transfers, and eCom purchases.

What is POST For Developers

How POST Smart Contracts Work

Smart contracts use PSDR (stable) for all transactions. Users pay in POST (volatile), which is converted to PSDR and locked in escrow until conditions are met.

The Token Flow

POST

Volatile

User pays in POST

Convert

Instant

At current rate

PSDR

Stable

Locked in contract

Settle

PSDR

Operators receive PSDR

PSDR Escrow

Funds are converted to stable PSDR and locked in the smart contract. No price volatility during the transaction lifecycle.

Automatic Execution

When conditions are verified (delivery, pickup, ID check), PSDR releases automatically to the correct parties.

Local Currency Payout

For money transfers, postal operators receive PSDR and pay recipients in local currency. No crypto needed by recipient.

International Postal Package

Smart contract locks PSDR for escrow, terminal dues, customs duty, carrier fees, and multi-party settlement

Complete Settlement: When a package crosses borders, the smart contract automatically settles terminal dues (destination post), customs duty (government), carrier fees (airlines), and network fees. POST Token settles all parties in real-time using PSDR, eliminating the 60-90 day settlement cycle.

Contract Creation - User Books International Package (DDP)

User (USA)

Pays $85.00

Ships package to Philippines

(Delivered Duty Paid)

Converts

34.7 POST

POST (volatile)

63.74 PSDR

PSDR (stable)

Converted at current exchange rate

via POST Gateway

Package Escrow Contract

Created

Locked: 63.74 PSDR

CONTRACT CONDITIONS:

Hold 63.74 PSDR in escrow until delivery
Terminal dues: 22.50 PSDR → Destination Post
Origin retention: 18.00 PSDR → Origin Post
Carrier fee: 7.50 PSDR → Airlines
Customs duty: 13.00 PSDR → Customs Authority
Network fee: 2.74 PSDR → UPU
Auto-refund if not picked up in 48h

Notifies

USPS

Origin Operator

Transit - Carrier Handoff & Origin Settlement

USPS

Hands off to carrier

PoT Scan

Airlines

International carrier

In Transit

Triggers

Package Escrow Contract

Active

Locked: 38.24 (remaining) PSDR

CONTRACT CONDITIONS:

✓ Pickup scan confirmed (PoT)
✓ Carrier handoff verified
→ Release 18.00 PSDR origin retention
→ Release 7.50 PSDR to carrier
Await customs clearance & delivery

Releases

Real-Time Settlement (PSDR)

USPS (Origin)

28%

18.00 PSDR

Airlines (Carrier)

12%

7.50 PSDR

Origin post and carrier paid instantly on handoff

Customs Clearance - Duty Settlement

PH Customs

Bureau of Customs

Cleared

Triggers

Package Escrow Contract

Active

Locked: 25.24 (remaining) PSDR

CONTRACT CONDITIONS:

✓ Package arrived at destination country
✓ Customs declaration verified
✓ Duty assessed: 13.00 PSDR
→ Release duty to Customs Authority
Await final delivery

Releases

Real-Time Settlement (PSDR)

PH Customs (Duty)

20%

13.00 PSDR

Customs duty settled instantly - no delays at border

Delivery - Terminal Dues Settlement

PHLPost

Destination Operator

PoD Verified

Triggers

Package Escrow Contract

Executed

CONTRACT CONDITIONS:

✓ Proof of Delivery recorded
✓ Signature/photo hash on-chain
✓ GPS coordinates verified
→ Release terminal dues to PHLPost
→ Network fee distributed
Contract completed

Releases

Real-Time Settlement (PSDR)

PHLPost (Terminal Dues)

35%

22.50 PSDR

UPU Network Fee

2.74 PSDR

Terminal dues settled instantly - no 60-90 day wait

Complete Settlement Breakdown

Total: 63.74 PSDR distributed to all parties throughout the shipment lifecycle

Terminal Dues

22.50 PSDR

→ PHLPost (Destination)

Origin Retention

18.00 PSDR

→ USPS (Origin)

Carrier Fee

7.50 PSDR

→ Airlines (Transport)

Customs Duty

13.00 PSDR

→ PH Customs

Network Fee

2.74 PSDR

→ UPU

Problem Solved: Terminal Dues Settlement

Old System (60-90 days)

Monthly paper-based reconciliation
Manual dispute resolution (247+ items)
SDR-denominated but settled in USD
FX losses on both sides
60-90 day settlement cycle

POST Token (Real-time)

Automatic settlement on delivery
Disputes resolved via PoT/PoD proof
Native PSDR (SDR-pegged) settlement
No FX conversion needed
Settlement in seconds, not months

Who Benefits & How

User

Pays all-in (DDP)
PSDR escrow protection
Auto-refund if no pickup

Origin Post

Instant origin retention
No price volatility
Paid on pickup scan

Carriers

Guaranteed transport fee
Paid on handoff scan
No invoicing needed

Customs

Duty paid on clearance
No collection delays
Full audit trail

Destination Post

Terminal dues on delivery
No 60-90 day wait
No reconciliation

UPU

Network fee revenue
Real-time audit trail
Zero manual work

International Money Transfer

Smart contract locks PSDR, destination post pays out in local currency

Payment Options: Sender chooses how to pay at the gateway - POST tokens, debit/credit card, or cash at post office. Fiat payments (card/cash) are in sender's local currency. All payments convert to PSDR for the smart contract. Recipient always receives local currency at their post office.

Payment Gateway Options

Sender chooses payment method - all convert to PSDR for the smart contract

Pay with POST

Direct token payment

Debit Card

Fiat (Local Currency)

Credit Card

Fiat (Local Currency)

Cash at Post Office

Fiat (Local Currency)

Transfer Initiated - Sender Creates Transfer

Sender (USA)

Pays $500 USD

Sends to Kenya

(via Debit Card)

Converts

$500 USD

POST (volatile)

375 PSDR

PSDR (stable)

Converted at current exchange rate

via POST Gateway

Money Transfer Contract

Created

Locked: 375 PSDR

CONTRACT CONDITIONS:

Amount: 375 PSDR (~$500 USD)
Recipient: John Doe, Kenya
Payout: Kenya Shillings via Kenya Post
Fee: 1.875 PSDR (0.5%)
PSDR rate locked at creation
Auto-refund if not claimed in 7 days

Notifies

Kenya Post

Notified of incoming transfer

Recipient Collects - Paid in Local Currency

Recipient (Kenya)

Shows ID at Kenya Post

ID Verified

Triggers

Money Transfer Contract

Executed

CONTRACT CONDITIONS:

✓ Recipient ID verified
✓ Biometric/PIN confirmed
→ Release 371 PSDR to Kenya Post
→ Kenya Post pays in Kenya Shillings
→ Fee distributed

Settles

Real-Time Settlement (PSDR)

Kenya Post

99%

371 PSDR

→ Pays out: 64,000 KES to recipient

Origin Operator Fee

0.5%

1.875 PSDR

UPU Fee

0.5%

1.875 PSDR

Recipient receives: 64,000 KES (Kenya Shillings) in cash at Kenya Post

P2P Transfer Alternative

For peer-to-peer transfers (not through postal operators), the recipient can choose:

Option A: POST

Receive POST tokens directly in wallet. Good for crypto-savvy users who want to hold or trade.

Option B: FIAT

Convert to local currency through an exchange or cash-out partner. Recipient chooses at claim time.

Who Benefits & How

Sender

Pay with POST or Fiat
Card, cash, or token
Only 0.5% total fee
Auto-refund protection

Recipient

Receives LOCAL CURRENCY
Cash at post office
No crypto knowledge needed
No hidden fees

Destination Post

Receives stable PSDR
Earns payout margin
Increases foot traffic
No currency risk

UPU

PSDR network fee
Compliance audit trail
Real-time reporting

eCom Purchase with Fulfillment

Smart contract locks PSDR for escrow, merchant payout, and shipping

eCom flow: Buyer pays POST → converted to PSDR → locked in escrow. Merchant receives PSDR (can convert to FIAT). Shipping operators receive PSDR. All settlements in stable PSDR.

Order Placed - Customer Checkout

Buyer

Pays 200 POST

Buys electronics online

Converts

200 POST

POST (volatile)

150 PSDR

PSDR (stable)

Converted at current exchange rate

eCom Escrow Contract

Created

Locked: 150 PSDR

CONTRACT CONDITIONS:

Product value: 135 PSDR (~$180)
Shipping: 11.25 PSDR (~$15)
Fee: 0.75 PSDR (0.5%)
Release 80% to merchant on ship
Hold 20% until delivery
Buyer protection: 14 days

Notifies

Merchant

Order received

Merchant Ships - First Release

Merchant

Ships package

Tracking Uploaded

Triggers

eCom Escrow Contract

Active

Locked: 27 (remaining) PSDR

CONTRACT CONDITIONS:

✓ Tracking number verified
✓ Package in postal system
→ Release 108 PSDR (80%) to merchant
→ Pay 11.25 PSDR to shipping operator
Hold 27 PSDR until delivery

Releases

Real-Time Settlement (PSDR)

Merchant (80%)

72%

108 PSDR

Origin Postal Operator

7.5%

11.25 PSDR

Merchant can convert PSDR to FIAT

Delivery Confirmed - Final Settlement

Delivery

Proof of Delivery

Confirmed

Triggers

eCom Escrow Contract

Executed

CONTRACT CONDITIONS:

✓ Tracking confirmed delivered
✓ Proof of Delivery on-chain
✓ 14-day protection window started
→ Release remaining PSDR
Contract completed

Releases

Real-Time Settlement (PSDR)

Merchant (Final 20%)

18%

27 PSDR

UPU Network Fee

0.5%

0.75 PSDR

Destination Operator

3 PSDR

Buyer Protection: 14-day window to dispute. 20% holdback can be refunded if product is defective.

Who Benefits & How

Buyer

Pays in POST
PSDR escrow protection
14-day buyer protection
Dispute resolution

Merchant

Receives stable PSDR
80% on ship (cash flow)
Can convert to FIAT
No chargebacks

Postal Operators

Receive stable PSDR
Guaranteed shipping fee
Last-mile delivery fee
No currency volatility

UPU

PSDR transaction fee
Dispute arbitration
Network coordination

Marketplace Purchase

Smart contract settles 7 stakeholders: Buyer, Marketplace, Origin Post, Carrier, Customs, Destination Post, Receiver

Marketplace Flow: Buyer pays via POST or Fiat (local currency) at the payment gateway. Payment converts to PSDR and is locked in escrow. All 7 stakeholders are settled automatically throughout the fulfillment lifecycle.

Buyer Payment Options

Buyer chooses payment method - all convert to PSDR for the smart contract

Pay with POST

Direct token payment

Debit Card

Fiat (Local Currency)

Credit Card

Fiat (Local Currency)

Cash at Post Office

Fiat (Local Currency)

Order Placed - Buyer Purchases on Marketplace

Buyer (Germany)

Pays €250 EUR

Buys from Japan seller

(via Credit Card)

Converts

€250 EUR

POST (volatile)

200 PSDR

PSDR (stable)

Converted at current exchange rate

via POST Gateway

Marketplace Escrow Contract

Created

Locked: 200 PSDR

CONTRACT CONDITIONS:

Hold 200 PSDR in escrow until delivery
Marketplace fee: 20 PSDR (10%)
Seller payout: 120 PSDR (60%)
Origin Post: 15 PSDR pickup/handling
Carrier fee: 18 PSDR (transport)
Customs duty: 15 PSDR (destination)
Destination Post: 10 PSDR (terminal dues)
Network fee: 2 PSDR (UPU)

Notifies

Marketplace

Seller (Japan)

Seller Ships - Marketplace & Origin Settlement

Seller

Ships via Japan Post

Tracking Uploaded

Japan Post

Origin Operator

PoT Scan

Triggers

Marketplace Escrow Contract

Active

Locked: 145 (remaining) PSDR

CONTRACT CONDITIONS:

✓ Tracking number verified
✓ Pickup scan confirmed (PoT)
→ Release 20 PSDR marketplace fee
→ Release 20 PSDR to seller (partial)
→ Release 15 PSDR to Japan Post
Await transit & delivery

Releases

Real-Time Settlement (PSDR)

Marketplace

10%

20 PSDR

Seller (Partial)

10%

20 PSDR

Japan Post (Origin)

7.5%

15 PSDR

Marketplace and origin paid on shipment

In Transit - Carrier Settlement

Airlines

International Carrier

In Transit

Triggers

Marketplace Escrow Contract

Active

Locked: 127 (remaining) PSDR

CONTRACT CONDITIONS:

✓ Package handed to carrier
✓ Transit scan confirmed
→ Release 18 PSDR to carrier
Await customs & delivery

Releases

Real-Time Settlement (PSDR)

Airlines (Carrier)

18 PSDR

Carrier paid on transit handoff

Customs Clearance - Duty Settlement

German Customs

Zoll (Customs Authority)

Cleared

Triggers

Marketplace Escrow Contract

Active

Locked: 112 (remaining) PSDR

CONTRACT CONDITIONS:

✓ Package arrived in Germany
✓ Customs declaration verified
✓ Duty assessed: 15 PSDR
→ Release duty to Customs
Await final delivery

Releases

Real-Time Settlement (PSDR)

German Customs (Duty)

7.5%

15 PSDR

Customs duty settled on clearance

Delivery - Final Settlement to All Parties

Deutsche Post

Destination Post

PoD Scan

Receiver

Package Delivered

Signed

Triggers

Marketplace Escrow Contract

Executed

CONTRACT CONDITIONS:

✓ Proof of Delivery recorded
✓ Receiver signature on-chain
→ Release terminal dues to Deutsche Post
→ Release remaining 100 PSDR to seller
→ Network fee to UPU
Contract completed

Releases

Real-Time Settlement (PSDR)

Seller (Final)

50%

100 PSDR

Deutsche Post (Terminal)

10 PSDR

UPU Network Fee

2 PSDR

Final settlement on delivery confirmation

Receiver in Germany gets: Product delivered - All 7 stakeholders settled automatically

Complete 7-Party Settlement Breakdown

Total: 200 PSDR distributed to all stakeholders throughout the fulfillment lifecycle

Seller Payout

120 PSDR

→ Japan Seller (60%)

Marketplace Fee

20 PSDR

→ Platform (10%)

Carrier Fee

18 PSDR

→ Airlines (9%)

Customs Duty

15 PSDR

→ German Customs (7.5%)

Origin Post

15 PSDR

→ Japan Post (7.5%)

Terminal Dues

10 PSDR

→ Deutsche Post (5%)

Network Fee

2 PSDR

→ UPU (1%)

Buyer Protection

14 Days

→ Dispute window

Who Benefits & How - All 7 Stakeholders

Buyer

Pay with POST or Fiat
PSDR escrow protection
14-day buyer protection

Marketplace

Fee on ship (cash flow)
No chargebacks
Stable PSDR revenue

Origin Post

Instant on pickup
No invoicing needed
Stable PSDR payment

Carrier

Paid on handoff
No settlement delays
Guaranteed payment

Customs

Duty on clearance
No collection delays
Full audit trail

Destination Post

Terminal dues on PoD
No 60-90 day wait
Automatic settlement

Receiver

Product delivered
Customs pre-paid
No hidden charges

Seller

60% payout guaranteed
Partial on ship
Final on delivery

Ready to Build on POST?

Integrate POST smart contracts into your postal services, marketplace, or payment platform.

API Documentation Contact Us