Separate Customer Errors From Provider Errors

Protecting customers and operations by separating product-safe failures from provider diagnostics. External providers frequently return messages intended for merchant operators. Passing them directly to customers can expose credentials, account permissions, liquidity information, or internal provider restrictions. Store two error representations: PaymentFailure( customer_message="Unable to complete this transaction. Please try again later.", provider_code=response.code, provider_reason=response.

Protecting customers and operations by separating product-safe failures from provider diagnostics. External providers frequently return messages intended for merchant operators. Passing them directly to customers can expose credentials, account permissions, liquidity information, or internal provider restrictions. Store two error representations: PaymentFailure( customer_message="Unable to complete this transaction. Please try again later.", provider_code=response.code, provider_reason=response.