Troubleshooting
No payments appearing
- Trustline missing: Ensure the payer has a trustline to the asset.
- Wrong asset: Verify the asset passed matches the
ACCEPTED_ASSETS. - Cursor stalled: Check if
/api/syncis returning failures orskippedLedgers.
Attribution missing but payments present
If payments are on the dashboard but missing route attribution:
- Hook not mounted: Ensure
@accensa/sdkis mounted in your server. - Signature rejected: Ensure your
MERCHANT_PRIVATE_KEYmatches theMERCHANT_PUBLIC_KEY. - Key mismatch: Verify your keys are Ed25519 keys.
Sync reporting skippedLedgers
- Your RPC provider may be limiting queries. Check
SOROBAN_RPC_URLlogs.
Refund rejected by policy
- Ensure the refund meets the criteria specified in the contract.