Testnet: Stellar-Native Payment — Full End-to-End Test

[0xdevcollins]

Summary

Complete a full Stellar-native payment end-to-end on testnet. This is the minimal viable beta flow — Stellar payer → Stellar merchant, no cross-chain bridging.

Test Scenario

• Payer: Freighter wallet on Stellar testnet
• Payment method: XLM or USDC on Stellar
• Merchant settlement: USDC on Stellar
• No bridge required

Steps to Validate

Setup

• Relay Stellar keypair configured and funded (testnet XLM)
• Soroban HTLC contract deployed and ID in .env (from Soroban: Deploy HTLC Contract to Testnet & Configure Relay #110)
• Settlement + Fee Collector contracts initialized
• Merchant account created in dashboard

Payment Flow

1. Merchant creates payment via API: POST /v1/payments with sourceChain: stellar, sourceAsset: USDC
2. Checkout URL opens correctly, shows order summary
3. Quote fetched: Stellar path payment route found
4. Payer connects Freighter wallet in checkout
5. Payer calls lock() on Soroban HTLC contract — funds locked
6. Relay detects Locked event from Soroban contract
7. Settlement contract executes: fee deducted, merchant amount locked
8. Relay calls withdraw() — reveals secret
9. Merchant receives USDC in their Stellar wallet
10. Payment status → COMPLETED in dashboard
11. Webhook fired to test endpoint (use webhook.site)
12. WebSocket pushes real-time update to dashboard

Pass Criteria

• Full flow completes under 30 seconds
• Merchant receives correct amount (gross - 0.5% fee)
• Payment status correctly transitions through all states
• Stellar tx hash visible and links to explorer
• Webhook received with correct payload