Best Practices

Recommendations for building robust integrations with Phoenix Wallet.

Idempotency

Always use idempotency keys for mutating operations to ensure safe retries.

Error Handling

Implement proper error handling with exponential backoff for transient failures.

Reservation Patterns

Use reservations for any operation that requires a hold before final capture.

Event Processing

Process events idempotently - the same event may be delivered multiple times.

Security

• Store API credentials securely
• Validate webhook signatures
• Use short-lived tokens