API errors
Example:
Payment statuses
Failed payments can be re-confirmed if a valid transaction hash is submitted before expiration.
Stellar network errors
op_no_trust
Cause: Missing USDC trustline on the customer or merchant wallet.
Fix: Add a trustline to the correct USDC issuer for your network. See Settlement wallet.
op_underfunded
Cause: Wallet balance is too low for the payment amount plus fees.
Fix: Fund the wallet with enough XLM or USDC.
op_line_full
Cause: Destination trustline limit reached.
Fix: Increase the trustline limit on the receiving account.
Issuer is invalid
Cause:STELLAR_*_USDC_ISSUER environment variable is missing or incorrect on the Payoes server.
Fix: Set the correct Circle USDC issuer for testnet or mainnet in your deployment environment.
Verification errors
Amount comparisons normalize Stellar’s 7-decimal format (
2 equals 2.0000000).
Getting help
- Check the transaction on Stellar Expert for the correct network
- Review Developers → API Logs for request details
- Confirm settlement wallet and trustlines are configured for the payment asset