#495 - cleaning up java docs and adding PaymentGatewayTransactionConfirmationService interface